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Using ProViz 
Video Digitizers 
With HyperCard 


Record the visual parts of 
your presentations with 
ScreenRecorder software. 


Then, record the narration 
of your presentations with 
MacRecorder software. 


Save your multimedia 
presentations to disk. 
Distribute them by 
e-mail or network server. 


MacRecorder 
sound digitizer. 


MacRecorder and ScreenRecorder will change the way you 
make, see, and hear presentations. Now it’s easier than ever to create 
multimedia presentations right on your own Macintosh. You can watch 
the presentations on your screen, on someone else's screen—or on 
both at once. See and hear more about these new Farallon products 
at a dealer near you. Call (415) 849-2331. Stay tuned. 


“: Farallon 


2201 Dwight Way, Berkeley, CA 94704 


Fax # (415) 841-5770. MacRecorder and ScreenRecorder are trademarks of Farallon Computing, Inc. 
Macintosh is a registered trademark of Apple Computer, Inc. © 1988 Farallon Computing, Inc. 


MASTERING 
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To get the most out of HyperCard, 
you need to harness the full power 
of HyperTalk. Mastering HyperTalk 
gives you all the tips and techniques 
you ‘Il need. 


Major features include: 

@ Adetailed appendix that covers 
the complete HyperTalk language 
version 1.2. 

@ Numerous examples of complete 
HyperTalk scripts. 

® Discussions of important concepts 
such as object-oriented program- 
ming, hypertext, and techniques 
for developing scripting tools. 

® Practical programming topics and 
algorithms include sorting, search- 
ing, graphics programming, and list 
and string processing. 

@ Stack applications that you can use 
or modify to suit your needs. 

@ Hands-on techniques for adding 
extensions to HypertTalk. 


Get your copy today and get 
all the power of HyperTalk! $24.95 


ABOUT THE AUTHORS: Keith Weiskamp is co- 
founder and editor of PC Al: The Artificial Intelli- 
gence Journal of Personal Computing and the au- 
thor of Artificial Intelligence Progamming with 
Turbo Prolog. Namir Shammas, editor of Turbo 
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books and written articles for BYTE, Journal of 
Pascal, Turbo Technix and other leading maga- 
zines in the field. 
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This depreciation calcula- 
tor can save you time and 
money 

— William K. Balthrop 


Find out what up 
at MACWORLD 


Attendance 1985 - 1988 Expo Booths 1985 - 1988 


| Sa © 


San Francisco Boston San Francisco Boston 
Up 144% Up 166% Up 300% Up 280% 


You can always count on seeing the newest, the best and the most at MACWORLD Expo. 
That’s why, year after year, the original Macintosh-exclusive computer show keeps getting 
more and more popular, both for users and for vendors. 


Fact is, MACWORLD Expo will: ¢ Introduce you to the latest Macintosh products... 

MACWORLD Expo has traditionally been the platform 
e Save you time and money ... by literally putting at for major new product announcements such as the 
your fingertips the hardware, software and peripher- SE/30 and HyperCard. You'll be at the forefront of new 
als that represent the entire state of the art of Macin- technology. 


tosh™ computing. You'll make smarter buying decisions. 
¢ Connect you with the best minds in the business... 
° Build i knowledge... by enabling you to attend through user group exchanges, advanced user tips 
a helpful tutorial that meets your specific need, sessions, and discussions with the industry’s veteran 
whether you use your Mac at the office, at school or at techies. You'll join a network of Macintosh pros. 
home. You'll learn from the experts. 
The next MACWORLD Expo to come in 19839 is: 
¢ Develop your skills ... by giving you plenty of op- 
portunities to practice what you've learned, using one BOSTON 
of the many Macintoshes that will be available to you. August 10-12, 1989 
You'll get hands-on experience. Bayside Expo Center ¢ World Trade Center 


The next move is Just fill in, detach and return the coupon below to MACWORLD Expo, Box 155, 
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Publisher’s Card 


If only I had a Universal Button. HyperCard buttons are wonderful. You can 
train them to do all kinds of tricks—but only within HyperCard. If only I could 
create a HyperCard button from within any environment, be it the system 
desktop, Microsoft Word, Excel, or my General Ledger package. If only I could 
train that button to do anything at any level, to any environment, and be active 
in only the environments I choose. 


It would work something like this: 


Say I pull down a Mac Menu and select an imaginary “Universal Button...” 
option. A dialog box appears asking general questions such as, “Where shall this 
button be active?” with a scrolling window of environmental options to select. 
Then a familiar dialog box appears for specifying a HyperCard button. When we 
select the script editor from this box, an enhanced version of HyperTalk is 
available that includes commands for manipulation of the Mac’s new operating 
system, system resources, and control of independent applications. 


The new Universal Button(s) will have to exist inside a transparent Universal 
Shell Window that overlays everything else within the Mac (or IBM, or Sun, etc.). 


Let’s go a step further and say this Universal Button can have HyperCard field 
attributes or other object’s attributes. Now we have a Universal Object. An 
extensible Universal Object with full access to any resource in the computer. 
Developing future applications depends on top programmers with a grasp of 
this environment and the existence of a very efficient HyperTalk compiler that 
can compile and then link modules of program code within a Universal Object’s 
script. A standard set of pre-compiled “Shell Objects” will be supplied. 


Is this the Object Oriented Interface of the near future? I think so. What things 
are pointing the way today? HyperCard, SuperCard, IBM LinkWay, and Wingz 
(this new graphic spreadsheet has buttons!) all have programmable objects and 
more such software is on the way. The desire for increased unification and 
standardization of the human/computer interface is driving the industry to a new 
standard. HyperLink Magazine’s coverage of these topics will have some small 
influence. 


Last issue we introduced Silicon Beach Software’s SuperCard to you. This issue 
we introduce JBM LinkWay. In the future, we will show you how to build 
buttons in Wingz. We will continue to bring you useful solutions to your world 
of business, education, and personal productivity. To unlock your creative self 
through showing you Object Oriented Interface manipulation and the expanding 
control of your computing environment. 


The future can wait while we explore today’s Object Oriented Interfaces within 
the pages of this issue. Enjoy then, this latest edition of the world of HyperLink. 


David G. Brader 


Roger Wood 
Editor 


Why “set userLevel” 

Have just received my Jan/ 
Feb 1989 issue with its Stack- 
Solutions disk. This is, with- 
out doubt, the most useful 
issue yet. The direction of the 
magazine justifies the faith 
from the beginning. 

I do have an aggravation. 
In Rhett Savage’s excellent 
column, “HyperCard Haiku,” 
there is a short script (Listing 
10) which blocks userLevel 
changes. One of the great 
strengths of HyperCard as a 
medium is that we who are 
not professional programmers 
can learn techniques and 
solutions from problems we 
face by examining and adapt- 
ing scripts of others. We do 
not have to reinvent the 
wheel. If that script starts 
showing up in general inter- 
est stacks, we will all be 
poorer. 

Mr. Savage hints at a 
reversal without being spe- 
cific. To get around that 
script, even at userLevel 1, 
send the following in the 
Message box: 


send - 
"set userLevel to 5" = 
to HyperCard 


As a matter of policy, I 
believe you should include 
reversing scripts for virtually 
anything you publish that 
attempts to block access to 
the medium. 

Mark Merritt 
Carmichael, CA 95608 


Thanks for the comments 
Mark. Admittedly, impeding a 
user from setting the user level 
can be annoying, but it is the 
stack developer’s prerogative 
to do so. Your method of get- 
ting around the script shows 
that to the crafty scripter, no 
barrier is too great. 
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Tips Feedback 


In the process of imple- 
menting the script in the 
“HyperCard Tips” column for 
locking and unlocking a field 
in the Jan/Feb 1989 issue, I 
discovered an intriguing fea- 
ture of HyperCard. When you 
hold down the Command key 
while clicking in a field, the 
text at the click is surrounded 
by a box and put into the 
Message box as well. Not 


_ only that, you can select sev- 


eral words, or a whole line, 
by dragging across the line 
while the Command key is 
down. Well, that led me to 
wonder if you couldn’t use 
that as a handy way to imple- 
ment a sort of Hypertext 
indexing technique. The 
script in Listing 1 is the result. 
Of course, you can put 
any kind of searching script 
you like inside the inner if 
loop. The outer loop is not 
really necessary, unless you 
wish for the mouseUp handler 
to do something different if 
the field is locked and the 
Command key is not down. 
A complaint: The maga- 
zine is for the most part quite 
useful. My complaint is that 
the experienced user is some- 
times lost in the shuffle. A 
case in point: In the “Xpand- 
ing HyperCard” column 
explaining glue routines and 
calls to the HyperCard Tool- 
box, a passing mention was 
made of the passFlag varia- 
ble. The function of that vari- 
able is not made entirely 
clear. Does HyperCard pass 
the XCMD name up the hier- 
archy before, during, or after 
the XCMD is run? What effect 
does this have on the opera- 
tion of the XCMD if any? Is 
this just a ploy to sell books? 
Gregory Krall 
Albuquerque, NM 87015 


The passFlag variable acts 
just like the pass command 
in any handler that you write 
in HyperTalk. After the XCMD 
is done, if the passFlag varia- 
ble is true then it passes the 


command (whatever the 
name of the XCMD is), up the 
object hierarchy. An XCMD is 
really not very different from 
any other handler, and if its 
name is the same as an 
already defined command in 
HyperTalk, setting the pass- 
Flag to true ensures that the 
normal HyperTalk command 
will execute. On the other 
hand, if the XCMD is 
designed to stop the normal 
action of a HyperTalk com- 
mand, then such an XCMD 
would set the passFlag to false. 


Invisible Objects 


Enclosed is the informa- 
tion for a stack that demon- 
strates a strange quirk in the 
HyperCard environment. As 
you know, the rect of a given 
button or field is given by 
top-left x, top-left y, bottom- 
right x, bottom-right y. Since 
this is the format, it is 
assumed that the top-left will 
be further up and to the left 
of the bottom-right point. But 
if this is not the case, the but- 
ton or field is “turned inside 
out,” and is not visible even if 
the visible of the object is 
true. This is a neat trick for 


empty then 
oe nee Sav eceunn 


showing and hiding but- 
tons and fields, because 
pressing Command-Option- 
Shift will not show these 
objects (of course this could 
be dangerous also!!!) 
Brad Smith 
Kismet Technologies 
Laurel, MD 20708 


Very interesting, Brad— 
and true too! If you type 


set the rect of button 1 
to 100, 100, 50, 50 


into the Message box (no line 
break), or put a similar com- 
mand into a script, when the 
command is executed, button 
1 disappears. If you then type 


put the loc of button 1 


into the Message box, Hyper- 
Card responds with 


75,75 


in the Message box—equally 
strange. An interesting anom- 
aly—anyone have any ideas 
as to how this could be a use- 
ful technique? 
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SuperCard Update 


Silicon Beach Software, devlop- In a related matter, at the prod- 
ers of SuperCard, (see the “Special uct announcement of SuperCard in San 
Report” in the March/April 1989 issue Francisco in January, Apple Computer's 
of HyperLink) told us as we went to Jean-Louis Gassée referred to a 
press that SuperCard is still on sched- “HyperTalk Language Standards Com- 


ule for a second quarter ship date. mitee.” At least a preliminary meeting 
When pressed, they said it would be of this committee has been held. 
released “as soon after MacWorld Among the attendees were Mike Holm, 


Washington as possible.” (MacWorld head of Technical Assistance on A world of 
Expo Washington is to be held on Apple’s HyperCard team, and represen- fe 
April 25-28.) tatives from Silicon Beach Software. inform ation 
is just a click 
away— 


| World Dataplaces 
| worlds of information 

| at students’ fingertips. 

| World Data ccapital- 
{izes on the power and 
{ practical use of 

| HyperCard™ on the 

4 Macintosh. 

{Point and click 

{ through 47 fields of 167 
| world states for 

{ information on: 


th The AnswerSource you can compare the features of 
the best available business software and hardware for the 
Macintosh® The AnswerSource will assist you in making 

_ informed buying decisions, and will also help you de- 

~ velop expertise in solutions cate gories that are new to 
you. You will be impressed by its depth and easy ac 
cessibility of product information... The AnswerSource 


published bi-annually and each issue includes: e politics 
e society 
° Easy to read articles detailing major market $ ution areas. e geography 
4 e economy, and 
. e states. 


101 ons, features, system 
requirements, pa ordering and technical aren information. 


: World Data authored 
e Information is supplied direct from the ae SS thus giving the : by Alice Jagger , Tom 
most accurate and up- to-date data available including the latest fea : Layton and Bob 
and version numbers. : f 


| Veeck, of Data Disc 
{ International, 2 discs. 
4 (HyperCard not included). 


Single user: $ 39.95 
_{ Site license: $ 119.95 


e Detailed glossary, color coding, and logical section di 
finding the Answers easy. 


| To order, contact: 
: ICCE 
1787 Agate Street 
University of Oregon 
Eugene, OR 97403 
(503) 686-4414 
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“Two thumbs Up: ee ime 
ORACLE for Ma 


cintosh. = 


\” Vl, “Atty © 


Ny 7, 
¢ Cr “Ong 


For only $199 until May 31. 


“T like the seamless way ORACLE gives “I like the seamless way ORACLE 
HyperCard full-power databaseand — Opens up minis and mainframes to 
networking capabilities. Teaming the 4th DIMENSION. Teaming the total 
total flexibility of HyperCard with the _ flexibility and strength of 4th 


strength of SQL is a masterstroke!” DIMENSION with SQL ts a master- 
Dan Shafer, Author of Hypertalk stroke, indeed.” 
Programming Guy Kawasaki, President of ACIUS, 


developers of 4th DIMENSION 


*Price becomes $299 after May 31, 1989. Stand-alone version licensed for developers only. Requires Macintosh SE or || with 2MB of RAM, 5MB hard disk space, floppy 
disk drive, and HyperCard 1.2. Includes 30-day installation support, ORACLE database, Hyper*SQL (HyperCard Interface), SQL*Plus, OCI and Pro*C (Macintosh 
Programmer's Workshop required for programming usage), System Stacks and Example Stacks. **Full networking version is $999 and includes SQL *Net (for database 
communications), Async, DECNet, TCP/IP support, Alisa System’s TSSnet DECnet protocol and drivers and Kinetics TCPort TCP/IP protocol and driver. Accessing data- 
base software on other machines requires a separate protocol handler and gateway software for the other machine. Call for additional information. Copyright © 1989 by 
Oracle Corporation. ORACLE is a registered trademark of Oracle. The other companies mentioned own numerous trademarks. TRBA 


pom there's one thing these two guys can agree 
on: ORACLE® for Macintosh. That’s because ORACLE 
for Macintosh now turns both HyperCard and 4th 
DIMENSION into full-function SQL databases. It also 
gives them transparent connectivity to over 80 dif- 
ferent systems, including PCs, DEC VAXs and IBM 
mainframes—even IBM DB2 and SQL/DS databases. 


No-Risk 30-Day Money-Back Guarantee 
Whatever application you're currently using— 
HyperCard or 4th DIMENSION—ORACLE for Mac- 
intosh gives you industry-standard SQL. $199* delivers 
the first and only SQL database available for the Mac. 
An additional $199 lets you access ORACLE from 
4th DIMENSION. Or for a limited time, $999** delivers 
all this, plus transparent access to remote ORACLE 
and IBM databases on your host systems. So call today. 
Our 30-day money-back guarantee is your assurance 
we'll deliver a four-star performance. 


COMPATIBILITY - PORTABILITY + CONNECTABILITY 
Call 1-800-ORACLE1, ext. 9235 today. 


Se ee eke 


be 
Dear Or acle Macintosh Direct Sales 


20 Davis Dr. * Belmont, CA 94002 + 1-800-ORACLE1, ext. 9235 


I have (check one) L] HyperCard 1.2 C) 4th DIMENSION Version 1.0.6. 
Enclosed ismy (CJ check, or CJ VISA C) MasterCard CL) AmEx credit card 
authorization for: 


___. xX $199 ORACLE for Macintosh Developer's Version $ 
(Includes HyperCard Interface. $299 after May 31, 1989.) 
___. x $199 ORACLE for 4th DIMENSION $ 
Available June 1989. (Requires ORACLE for Macintosh 
and 4th DIMENSION.) 


___. x $999 ORACLE for Macintosh Networking Version $ 
(Includes an unrestricted license of ORACLE for Macintosh, 
SQL+Net Networking Software and protocols for Macintosh 
and, for a limited time, ORACLE for 4th DIMENSION.) 


Please add appropriate sales tax § 

Shipping and handling $ eS. 
Total (Offer valid only in USA) § 

NAME TITLE 


COMPANY 

STREET (no PO. boxes, please) 

CITY STATE ZIP 

TELEPHONE 
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Here Are Some How-to Tips on Using Some of the More 
Frequently Encountered SQL Commands 


SOL Basics, Part 2 


by Dan Shafer 


n the last issue, I introduced the basic SQL com- 

mands for setting up a database for a delicatessen. 

We concentrated in that discussion on the CREATE 
TABLE and INSERT commands that are used to build da- 
tabase tables and place values into them. In this issue, 
we'll turn our attention to the process of extracting in- 
formation from SQL databases with the deceptively sim- 
ple EXTRACT command. 


This application consists of seven tables: 


e INGRED (containing ingredients used by the deli) 

e CUST (containing customer information) 

e ADDRESSES (containing building addresses of major 
clients with multiple locations) 

e CUST_TYPES (containing customer type codes and 
their descriptions) 

e ORDERS (containing ordering and payment 
information) 

e ORD_TYPE (containing order type codes and their 
descriptions) 


The CUST table has the structure shown in Figure 
1. Figure 2 shows the contents of the file that we will as- 
sume in our discussion of the SELECT command. 


Starting Simply 

The simplest form of the SELECT command tells 
SQL to extract all of the contents of all of the columns 
from a named database table. To extract all of the data 
from the CUST table in our example, the command is: 


SELECT * FROM CUST; 


Used without HyperCard on a non-graphic termi- 
nal (or under MPW on the Macintosh), this would pro- 
duce a tabular listing of all of the contents of all of the 
fields, much like that shown in Figure 2, with column 
headings. The asterisk simply tells SQL to select all of 


Dan Shafer is the author of HyperLink’s regular “Shafer 


On Scripting” column. He is also President of Strategy 
Consulting, the first certified ORACLE Mac consultant, 
and author of the soon-to-be-published book Using ORA- 
CLE with HyperCard (Hayden Books). 
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Column Name © 
Customer 1D 

last Name  #&h 
First Name 


Building ~ 

Phong, sri‘ és 
Extension ——s Ch 

Customer Type © 


Figure 1 
Structure of CUST Table 
the columns in the table. 

We often want to choose information from only 
selected columns, however. In that event, we just re- 
place the asterisk in our previous example with a com- 
ma-delimited list of the fields we wish to extract. For ex- 
ample, let’s say we want to build a phone list we can 
print and keep next to the phone for returning calls and 
making sales contacts. We want this listing to show us 
the customer’s last name, first name, company, phone, 
and extension. Here’s the SQL command that would 
produce such a listing: 


SELECT LAST_NAME, FIRST_NAME, COMPANY, PHONE, 
EXTENSION 
FROM CUST; 


Again, assuming we are running the SQL database 
outside HyperCard, the result of this command would 
be a neat, if somewhat plain-looking, tabular listing of 
all of the customers in our database, showing each one’s 
name, company, and phone contact information. In fact, 
all SQL SELECT commands produce such listings. When 
we talk about how this command is used with some ex- 
tensions in Hyper*SQL from ORACZE in conjunction 
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with a HyperCard stack, we'll see 
the other presentation options from 
which we can choose. 


Sorting in SQL 

The two previous example 
commands produce tabular reports 
on the display and present the data 
in the order in which it is stored in 
the database. This order probably 
bears no relationship to reality even 
though we’ve shown in Figure 2 that 
the data is stored alphabetically by 
customer last name. It is probably 
stored somewhat randomly, particu- 
larly if additions and deletions to the 
data have been made since the table 
was first loaded. If we wanted the 
customer list sorted by customer last 
name, for example, we could write 
an SQL query like this: 


SELECT * FROM CUST 
ORDER BY LAST_NAME; 


Similarly, if we wanted to put 
the phone list in company order, we 
could write a query like this one: 


SELECT LAST_NAME, FIRST_NAME, 
COMPANY, PHONE, EXTENSION 
FROM CUST 

ORDER BY COMPANY ; 


As you can see, SQL’s sorting 
capability is quite straightforward. 
You can specify sorts in descending 
order by placing DESC after the word 
COMPANY above. 


Only Want to See... 


We rarely want to see all of 
the data in a file, or database table. 
We have already seen how to de- 
scribe the columns to be extracted 
from the table. But what if we want 
only those records (rows in SQL par- 
lance) that match certain selection 
criteria? In SQL, this kind of selective 
data extraction is accomplished with 
the WHERE clause in a SELECT com- 
mand. For example, let’s say we 
want a phone list that only shows 
our regular customers (i.e., those 
with a Customer Type of REG in Fig- 
ure 2). The SQL command selecting 
the appropriate columns from only 
those rows would be: 


SELECT LAST_NAME, FIRST_NAME, 
COMPANY, PHONE, EXTENSION 
FROM CUST 

WHERE CUSTOMER_TYPE = 'REG' 
ORDER BY COMPANY ; 


12 


Last | 
Name : 


Allen 
Bacon 
Ellison 
Howard 
Howard 
James 
Miller 
Miller 
Schafer 
Wilson 


Name 


Jerry 
Sharon 
Laurie 


Andrew 
Burton 
Andrea ~ 
Aaron 


Company 


National Can 43 

National Can 42 

Delphi Corp 
Stephanie National Can 42 

/ National Can 42 

Delphi Corp 
Smythe Incline 
Delphi Corp 
Christine Apricot Press 
Ferdinand National Can 44 


Bldg. Phone 


123-4567 
123-5678 
555-4123 
123-5678 
ae S078 
555-4223 
487-0009 
555-4422 
944-8540 
123-4565 214 


Figure 2 
Typical contents of a file stored in the structure of CUST Table shown in Figure 1 


Meaning 
equal to 
not equal to 
greater than 


greater than or equal to 


| less than 

<= =————s—s—=Ci=—CiCCiess then or equal to 
BETWEEN...AND.. | between two values 
In | contained in a list provided as an argument 
LIKE matching a pattern of characters 
IS NULL value is null (i.e., has no value) 

Table 1 

SQL Logical Operators 


You now begin to get some of 
the “flavor” of SQL. Much of your 
work with SQL will consist of creat- 
ing SELECT commands of varying 
degrees of complexity. And these 
commands can become extremely 
complex. For example, let’s say we 
now want to limit the phone list to 
regular customers who work for Na- 
tional Can. The query would look 
like this: 


SELECT LAST_NAME, FIRST_NAME, 
COMPANY, PHONE, EXTENSION 
FROM CUST 

WHERE CUSTOMER_TYPE = 'REG' 
AND COMPANY = "National Can' 
ORDER BY COMPANY; 


Notice the word AND joining 
two conditions: CUSTOMER_TYPE = 
"REG" and the newly added 
COMPANY = "National Can’ entry. 
This would produce a phone list 
containing only the names and con- 
tact data for Jerry Allen and Stepha- 
nie Howard from our example in 
Figure 2. 

This ability to perform selec- 
tive or conditional data extraction 
from SQL tables is among the lan- 
guage’s most powerful features. Ta- 


ble 1 shows the various logical oper- 
ators that can be used in SQL quer- 
ies. As you can see, the range is far 
more extensive than that available in 
HyperTalk or in any general- 
purpose programming language. 

As one example of the power 
of these logical operators, consider 
the possibility that we want to print 
a list of the names and companies of 
all of our customers who fall into 
any category other than occasional 
(i.e., with a CUSTOMER_TYPE other 
than OCC). The following SQL query 
would do the trick: 


SELECT LAST_NAME, FIRST_NAME, 
COMPANY 

FROM CUST 

BOGhe Lot Iter. ULC = 

CUS Eth P es G stot YPE 

ORDER BY COMPANY ; 


As you may already have antic- 
ipated, we can also use an OR logical 
connector as we have used the AND 
in previous examples. To get a list 
of all of our customers who are ei- 
ther regular customers or who work 
at Apricot Press, for example, we 
could write the following query: 

—continued on page 24 
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An Introduction to Neural Networks 


The “Letter Learner” Stack 


by Robert Orenstein 


eural networks are a hot topic in computing 
right now. The general computer user’s interest 
in neural networks is exceeded only by his ina- 
bility to understand most of the articles that have recent- 
ly been written about them. This is the fault of the litera- 
ture, not of the reader. Most of the articles are of a 
highly technical nature, and many describe methods of 
using neural networks to accomplish tasks that could 
easily have been accomplished using ordinary simple 
programs. For example, an article in another magazine 
described how to use a neural network to count votes 
for one of two candidates in order to determine which 
candidate won an election. Clearly a neural network is 
not necessary to accomplish this task. 


“Letter Learner” is a HyperCard stack, 
and its safe to say that without 
HyperCard, Id still be just 
starting the project. 

I’ve recently written a stack, called NeuralStack 
One: “Letter Learner” that is meant to explain neural net- 

works in an intuitive, easy-to-understand way. Figure 1 
is thte basic screen of “Letter Learner.” In this article, I 
will first discuss neural networks in general, and then 
move to a specific discussion of “Letter Learner.” Weigh- 
ing in at a hefty 400,000 bytes, including 6 Turbo Pascal 
XCMD’s, “Letter Learner” is not a stack that you can easi- 
ly replicate on your own. However, in this article, I 
hope to give you enough information to understand the 


basic ideas behind neural networks, and to understand 
how “Letter Learner” works. 


What Is a Neural Network? 


If you were to compare a twenty-page description 
of a Macintosh with a twenty-page description of an 


Robert Orenstein is a HyperCard consultant in Venice, 
California. He is currently working on NeuralStacks Two 
and Three. 
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Figure 1 
When you first start Letter Learner, it looks like this. Through 
drawing letters with the mouse in the box in lower middle of the 
screen, and pressing on the appropriate letter in the box to the 
left, you “teach” the stack what the letter is by example. 


IBM mainframe, you would find the two machines to be 
very different. If you were to read five-page descriptions 
of the same machines, the descriptions would be more 
similar. A five-sentence description of the two machines 
would be identical to each other. That’s because funda- 
mentally, all computers today use the same basic archi- 
tecture (something called the Von Neumann model), 
and the differences between two machines are simply 
differences in the way that the basic model is imple- 
mented. If I were to give you a five-sentence description 
of a neural network, however, it would be entirely dif- 
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ferent. That’s because a neural net- 
work is unlike any machine current- 
ly available. Rather than use the Von 
Neumann model, a neural network 
takes the basic concepts underlying 
the brain as its architecture. In fact, 
the five-sentence description of the 
brain and the five-sentence descrip- 
tion of a neural network would be 
identical, even if the twenty-page 
descriptions are entirely different. So 
what are some of the differences be- 
tween the standard computer and a 
neural network? 


Neural Networks Are 


Not Programmed 

Any standard computer must 
be programmed. If I wanted one to 
learn the differences between twen- 
ty peoples faces, I would have to 
program the machine with a list of 
rules to tell the faces apart. Neural 
networks are not programmed; rath- 
er, they are trained. If I want a neu- 
ral network to tell twenty people 
apart, all I have to do is show ita 
few examples of each face. 

This is the same way that peo- 


ple learn. When you were a baby, 
you learned your parents’ faces 
without any rules explained to you 
to help you do so. How did you do 
it? You learned by example. You saw 
your parents’ faces 500 times or so, 
and eventually you could tell one 
from the other. 

Neural networks work in a 
similar way, and use the same basic 
methods that the brain does. Both 
the brain and neural networks are 
made up of neurons, which are con- 
nected by synapses. Knowledge is 
stored in the synapses, by the 
strength of the connections between 
the neurons. (In a neural network, 
neurons are usually given other 
names, such as “processing ele- 
ments” or “units.” I have chosen the 
term “neurode,” which is more de- 
scriptive, and keeps the analogy to 
neurons evident). Although neural 
networks are similar to brains, the 
brain is billions of times more com- 
plex, and although the brain can 
adapt itself to many tasks, a particu- 
lar neural network is usually built to 
perform only one task. 

If a neural network is different 


1MEG SIMMs 


256K SIMMs 


BEST PRICES IN USA! 


(-] Prompt Delivery 
(-] 2 Year Warranty 
[-] 100% Product Testing 


1-800-365-SIMM 
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[J Both DIP and Low Profile Available 

(-] Full Installation Instructions Included 

[1] VISA, MasterCard, C.O.D. Orders Accepted 
[] 120 ns to 80 ns Speeds, SIMMs & SIPs for Macs & IBMs 


Computer Product Center 


Call Today! Get Off the Memory Waiting Lists! 


4410 Stamp Rd., Suite 200 
Temple Hills, Maryland 20748 


Figure 2 


from a regular computer, then how 
can we run a neural network on a 
Macintosh? Rather than build the 
neural network from hardware, we 
can simulate it on the Mac via a pro- 
gram. The program contains instruc- 
tions that allow it to learn from ex- 
perience. It runs more slowly than a 
true hardware neural network. For 
example, even if we were to pro- 
gram a neural network on a Cray 
XMP, the fastest machine currently 
built, we would have less power 
than we need to simulate a leech. 


Uses of Neural 
Networks 


So what can we use neural 
networks for? Although they have 
many functions, the class of prob- 
lems that I find the most interesting 
involve pattern classification. These 
problems involve looking at a partic- 
ular object and deciding which cate- 
gory the object falls in. For example, 
which letter of the alphabet has 
been drawn in Figure 2? 

Trivial task, right? For you, yes. 
For a computer, no. Think about 
it—you’ve never seen that particular 
letter R before, exactly that shape 
and size, and yet you could immedi- 
ately classify it as an R. And, unlike 
an ordinary computer program, you 
don’t have to learn any rules to be 
able to do this. You simply have ac- 
cumulated experience in recognizing 
letters, and this allows you to look 
at this particular pattern of lines and 
classify it into one of 26 categories, 
the letters of the alphabet. 

Neural networks are built to 
handle exactly this type of task. A 
voice recognition neural network 
might be able to listen to a voice 
and tell you whose voice it is. A 
neural network currently in use at a 
bank acts as a loan officer—based 
on past examples, it can look at a 
loan application and classify it as 
“Good loan risk” or “Bad loan risk.” 


—continued on page 43 
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This Depreciation Calculator Can 
Save You Time and Money 


The “Fixed Assets” Stack 


by William K. Balthrop 


ousing and equipping a business can require a 
H large investment in property. The property may 

be land, buildings, office furniture, tools, even 
copyrights and patents. This property is referred to as 
fixed or long-lived assets. 

There are two principal types of fixed assets: tangi- 
ble and intangible. Tangible assets are classified as 
either real property and personal property. Real prop- 
erty includes things such as land, buildings, or other 
structures attached to the land. Personal property con- 
sists of items such as office furniture, equipment, tools, 
and fixtures. The intangible assets of a company include 
copyrights, trademarks, patents, organization costs, and 
goodwill. 

The first thing you need to know about an asset is 
the cost of acquisition. This includes the purchase price, 
shipping charges, and any expense such as installation 
charges, required to make the asset ready for service. 

Through the use of an asset a company accrues 
normal expenses such as maintenance, repairs, and 
insurance. All of these costs are visible and deductible. 
There is also an invisible cost which must be accounted 
for. As most assets are used by the company they 
become old and wear out. An asset has only a limited 
life before it must be retired or salvaged. There are three 
major terms used by accountants to account for this 
expense: depreciation, depletion, and amortization. 

Depreciation is the term used to describe the trans- 
fer of an asset’s acquisition cost to an expense which 
can be deducted. Assets which can be depreciated are 
buildings, machinery, equipment, and fixtures. Land can 
not be depreciated, as land once used, is always still 
land and does not wear out. Things which grow on the 
land, however, such as timber, or reside within the land 
such as minerals or oil, however can be removed. 
Removing these items does decrease the value of the 
land, and Depletion is the term used to describe this. 

Just as tangible assets get old and wear out from 
use, many intangible assets also have a useful and legal 


William “Kelly” Balthrop is the Director of R & D at 
HyperLink and has been developing and publishing com- 
puter software for the last decade. 
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life span. The acquisition cost of these assets should be 
spread over their life span. This process is called 
amortization. 

Before this article turns into an accounting text 
book, let’s just say that there is a lot of work involved in 
tracking all of the assets within even a small company. 
We have developed a HyperCard stack that takes much 
of the drudgery out of tracking assets. The “Fixed 
Assets” stack lets you to maintain a database of your 
assets and helps you figure the depreciation schedules 
for those assets. 


Using the “Fixed Assets” Stack 


Upon opening the stack you are presented with a 
screen like the one shown in Figure 1. Enter a descrip- 
tion of the asset along with any address or location 
information. If your assets are currently filed in another 
manner with reference numbers, you may include your 
own reference number, or by clicking on the “Auto” but- 
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ton, you can generate a new unique 
reference number for your asset. 
Below the reference number enter 
the total acquisition cost of the asset. 
Remember this includes all costs 
required to put the asset into 
service. 

To the right of the reference 
number is the asset type. Click on 
the rectangle to the right of “Asset 
Type.” This displays a list of types 
from which to choose. Click on any 
one to select it. If you would like to 
change an entry or add your own 
custom option, click on the lock 
icon in the upper-left corner of the 
field. This unlocks the text in the 
field so that it may be edited. To 
lock the field so you can make a 
selection, click on the lock symbol 
again. Just click outside the field to 
cancel the entry of a new option. 

Below the asset type is the 
“Date Acquired” field. You may 
enter the day the asset was placed 
into service, or simply press the 
“Today” button to automatically 
enter the current date. 

On the left side of the screen, 
below the acquisition cost is the 
“Depreciation Type” field. Each asset 
can simultaneously maintain up to 
three depreciation options using dif- 
ferent methods of depreciation. This 
field indicates which of those three 
options is being used to calculate 
depreciation to date. To switch 
which option is being used, click on 
the current option. The three 
options are listed in a field. Simply 
select one by clicking on it. 

After selecting it, the method 
being used by that option is dis- 
played in the field “Depreciation 
Method” to the right. In Figures 2 
and 3 we see that Option 1 is 
selected and is using Straight-Line 
depreciation. If the option selected 
were Manual, then the fields for 
Depletion and Amortization would 
unlock so you could enter whatever 
you want for YTD (Year to Date) 
and total values. 

The “Life of Asset” field is the 
useful and legal life given to an 
asset in years. To determine the this 
for your assets you should consult 
your accountant or a tax guide. The 
number of years you enter deter- 
mines how many years over which 
the depreciation is spread. 

The “Units in Life” field is used 
only when you are going to use the 
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Figure 2 


Units-of-Output method of deprecia- 
tion. Lets say, for example, you buy 
a new stamping press. This press is 
rated to have a lifetime of one mil- 
lion stamp cycles. For every stamp 
cycle the machine is put through 
you will be able to depreciate 1 mil- 
lionth of the acquisition cost. If you 
run the machine through 100,000 
cycles in one year, you could depre- 
ciate 10% of the acquisition cost. In 
the “Units of Life” field, you should 
indicate the total number of units in 
the asse’s life. In the case of our 
example that would be 1000000 
(Please note: Do not use commas 
when entering large numbers into 
fields). 

The “YTD Units” field is auto- 
matically updated from the table that 
is compiled for the Units-of-Output 
method of depreciation. If Units-of- 
Output is not being used this value 
should be 0 or left empty. 

The “Decline Rate” field indi- 
cates upon what rate the declining 
balance is based, if the declining 
balance is the depreciation type 
being used. A 200% declining bal- 
ance is also called double-declining 
balance, and is the maximum rate 
legally allowed. A 100% declining 
balance is calculated the same as 
straight-line depreciation, so the 
decline rate must be between these 
two values. 

Below the declining balance 
rate is the “Salvage Value.” When an 
asset Wears out, it might be salvaged 
for some amount of money—e.g., as 
scrap metal or other recyclable 
material. This salvage value is what 


the asset would be worth after the 
life of the asset has expired. The sal- 
vage value may be deducted from 
the acquisition cost before doing the 
depreciation calculation. If you want 
the salvage value deducted from the 
acquisition cost, then enter the sal- 
vage cost, and click on the button to 
the right marked “Use.” You may 
retain the salvage value for your 
records, and not have it deducted 
from the acquisition cost by not 
clicking on the “Use” button. When 
calculating the declining-balance 
method of depreciation, no salvage 
value is allowed. The stack takes 
care of this for you, even if you 
select the “Use” button, by not 
including the salvage value in 
declining-balance calculations. 


The Tables 


In the center of the screen in 
Figure 2 are three magnifying 
glasses. Clicking on one of these lets 
you view the tables of information 
for depreciation, depletion, and 
amortization. Clicking on the top 
magnifying glass shows you the 
three tables used for calculating 
depreciation (see Figure 3). The left 
side of each table shows the years 
that make up the asset’s life. At the 
top of each column is a box. Click 
on this box to display a list of the 
depreciation options. The following 
options may be selected: 


e None 

e Straight-Line 

e Declining-Balance 
e Declining-Strait 
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Fixed Assets 
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e Sum-of-Years-Digits 
e Units-of-Output 
e Manual 


Click on one of these options 
to calculate the table. When it is 
done, the method is displayed in the 
box, and the depreciation for each 
year is placed in the field next to the 
years. The entire life of the asset is 
calculated, even if the asset is only 
one day old. You can enter up to 
three different methods of deprecia- 
tion and view them side-by-side to 
see the differences between depreci- 
ation methods. You can later chart 
these values with a built-in charting 
screen (see Figure 4). In order to 
calculate year to date (YTD) depreci- 
ation on the main screen you need 
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Figure 4 


Option 1 
ae Option 2 
: Option 3 


to have at least one of these 
options filled out with values for 
yearly depreciation. 

If you are using the “Units- 
of-Output” option with the tables, 
you must enter the number of 
units followed by a comma, fol- 
lowed by the amount of money 
the items are worth. 

To enter values for deple- 
tion click on the middle magnify- 
ing glass. A single table is dis- 
played with a line for each year. 
Manually enter the depletion for 
each year, then click anywhere 
outside the field to close it. Click- 
ing on the magnifying glass for 
amortization works in the same 
way as depletion. 


Speed Up HyperTalk's 
Numerical Calculations 
with 
CLR HyperArrays 


CLR HyperArrays contains 
24 XCMD's and XFCN's that 
speed up numerical 
calculations on arrays from 
10 to 100 times!! 


Capabilities include: 


Sort a field of characters 
Sort a field of integers 
Delete empty lines 

Test if a value is a number 
Test if a value is an integer 
Sum 

Sum of squares 

Minimum of an array 
Maximum of an array 
Matrix addition 
Matrix transpose 
Matrix multiplication 


and More! 


Example scripts demonstrate 
use of all XCMD's and 

XFCN's. All are very easy to 
use. 


Only $65 + $3 shipping and 
handling. 
Visa/mastercard and PO's 
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Note that “Units-of-Output” 
and depletion are simply two ways 
of figuring the same thing. The only 
difference is that the amount that is 
entered into the “Depletion” field is 
in dollars, and the amount entered 
into the “Units-of-Output” table is 
both units and dollars separated by 
commas. The stack does not verify 
that the dollar amounts are identical, 
you need to check that they are the 
same if that is appropriate. 

Depletion and amortization 
values are computed based on the 
values entered into each table. The 
YTD figure represents the depletion 
or amortization for the current year, 
and the total value is the accumu- 
lated total to date. 

In the lower-right corner of the 
screen are two date fields. “Date of 
Value” is the date that is used to do 
all calculations. You may click on 
the button “Today” to have today’s 
date automatically entered. The 
“Date Sold” field is for reference 
only. If you wish to calculate the 
Book value as of the date sold, enter 
the same date into both of fields. 

The “Book Value” is calculated 
by subtracting total depreciation, 
depletion, or amortization from the 
acquisition cost of the asset. The 
“Actual Value” is either the price 
obtained through salvage, sale or 
simply an estimated value if the 
asset is till in service. The “Book 
Value” is then subtracted from the 
“Actual Value” to obtain the “Taxa- 
ble Gain/Loss” for the asset. This 
value indicates your taxable equity 
in the asset. 

There are several buttons at 
the bottom of the screen (see Figure 
1 or 2) that help you maintain your 
database of assets. Table 1 shows a 
list of the buttons and their 
purposes. 


Charts 

When you select the “Charts” 
button at the bottom of the screen, 
you are taken to the “Charts” card. 
From here you can plot any of the 
three depreciation options which 
were set up on the main card. These 
depreciation tables must already be 
entered before you can plot them. 
The example shown was created by 
selecting “Option 2” from the 
“Graph” field at the bottom of the 
screen. Select an option simply by 
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New - Creates a new asset card. 

Delete - Deletes the current card. 

Calculate - Calculates the YTD and Total depreciation, depletion, and 
amortization. It also calculates the current book value and your taxable 


gain or loss. 
Charts - Takes you to the “Charts” card (discussed below) 
Find - Allows searching for assets by the description field. 
Print - Prints the current screen. 


Table 1 
A list of the buttons across the bottom of the main screen of the “Fixed Assets” stack. 


Listing 1 - Stack cert for “Fixed Assets” stack 


on “OpenStack : 

global DelCard 

"put false into Delcard 
_ e menubar  . 
hide msg 
end OpenStack 


on doMenu comand 
global DelCard 
af Deitard i true then 


pass. dowen. 

: exit doMenu 

end if 

if Command is "New Card" 

then send "mouseUp” to bg btn "New" 
else if Command is "Delete Card" then 
send "mouseUp” to bg btn “Delete” 
else pass doMenu 

end doMenu 


on None 
global Origin,Graph 
a empty into Graph 


if Origin is "Opt2" then put Graph into fld "Ont2 Values" 
tas is a ue a’ are into fld “Opt3 Values"| 


Meets. Life, Book. Laoett, Fmonth, oe Lm, Fyear 

global Lyear,RealAge,flag2,Perl AqCost, Origin, Graph 
SetUp 

if not flag2 then exit Straight_Line 

put empty into Graph | 

- put 0 into Total _. 

put CheckNum(Book / Life * Fm) into line 1 of Graph 

add line 1 of Graph to Total 

a CheckNum( Book yatta) 

or ith x=2 to trunc(Life) ~~ e 

net cursor. to busy 

cn TotaT + it > Book then 


“See then put Graph into fld “Opti Values” 
S Opte” then put Graph into fld "“Opt2 Values" 
is “Opts” then “ Graph nko fld “Qpt3 Values” 
line oe 
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OpenStack - Hides the menu bar when the stack is opened. 

None - Clears the table when no depreciation schedule is desired. 

Straight_Line - This routine is responsible for calculating straight line 
depreciation. It builds the table for the life of the asset, then plugs that 
table into the appropriate option table. It is the simplest type of 
depreciation. 

Declining Balance - This routine calculates the declining balance depre- 
ciation table. The resulting table is then plugged into the appropriate 
option table. To use this method you must have value between 100 
and 200 entered into the “Declining Rate” field on the main card. 

Declining Straight - This routine calculates a declining balance depreci- 
ation until such a time that a straight-line depreciation allows for more 
depreciation than the declining balance method. The optimum point at 
which the routine switches from declining balance to straight line is 
automatically calculated. 

Sum_of_Years_Digits - As the name implies, this routine calculates the 
Sum of Years Digits method of depreciation. 

Units_of_Output - This routine calculates the units of output. In order 
for this routine to work, you must first enter the number of units used 
in each year into the table. Then select the Units_of_ Output option. 
The money amount is put into the second item of each line, and the 
number of units is maintained in the first item. 

Calculate - This routine is responsible for taking the selected table of 
depreciation values, and calculating the YTD depreciation for the date 
of value, as well as the total accumulated depreciation. 

Manual - This is a dummy routine created simply to interrupt the system 
message being sent when the Manual method of depreciation is 
selected. 

Finish - This routine calculates Book value and the taxable gain or loss 
for the asset. 

FinishAmortization - This routine updates the YTD and total amortiza- 
tion values from the amortization table, based on the date of value. 

FinishDepletion - This routine updates the YTD and total depletion val- 
ues from the depletion table based on the date of value. 

FinishUnits - This routine updates the “Units Used” field from the depre- 
ciation table that is also used to maintain the number of units used 
each year. 

SetUp - This routine sets up many of the parameters required for calculat- 
ing depreciation. 

Age - This routine calculates an asset’s age, as well as the fractional part 
of the first year of depreciation and the fractional part of the final year 
for calculating the current date depreciation. 

Graphit - This routine uses one of the three depreciation tables created 
on the main card, and draws a line graph of the asset’s depreciation. 

ClearScreen - This routine clears the graph. 

CheckNum - This commonly used function is responsible for validating 
legal numbers and converting them into the proper format. 

ClickLine - This function returns the line clicked on within a field when 
called from within that field’s script. There are two modes to this 
function: 

e ClickLine( ) - returns the line number clicked on. 

¢ ClickLine(stuff) - returns the contents of the line clicked on. 


Table 2 


This describes the handlers in the “Fixed Assets” stack script. 


clicking on it. The depreciation is 
plotted year by year, and the 
method is displayed in the “Depreci- 
ation Method” field. The values at 
the left of the graph are calculated 
based on the highest value in the 


table to be plotted. The scale at the 
bottom of the graph always reads 0 
to 50 years. 

Clicking on the “Clear” button 
in the lower-left corner of the card 
clears the graph area. The “Grid” 
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button overlays a grid on the graph 
to make it easier to read. Click on 
the “Grid” button again to make the 
grid disappear. The “Print” button 
prints the current screen to the 
printer. To return to the main screen 
for your asset, click on the return 
arrow in the lower-left corner. 


The Stack Script 


The key to this stack lies in the 
stack script that performs the depre- 
ciation calculations. These scripts 
can be used to create your own 
applications, or you may wish to 
obtain the StackSolutions disk from 
HyperLink Magazine which contains 
the Fixed Asset stack in its entirety. 

The stack script, reproduced in 
its entirety in Listing 1, contains the 
bulk of the scripts for this stack. 
Table 2 gives a brief explanation of 
what each of the various handlers 
do in the stack. If you do try to use 
these scripts make careful note of 
how the global variables are being 


used. 


—Listings continue on next page 
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—MacWorld 1988 


Copyrights, Trademarks & Patents 
Easy-to-Use Federal Guidelines 
at your Fingertips tell you: 
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Listing 1 - cont. 
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Listing 1 - cont. 


into fld “Opt3 Values” :  «w 
end Sum_Of_Years Digits 3 


woes _of_ Output 
global AssetAge,Life,Book,Lmonth 
global Fmonth,Fm,Lm, Fyear, Lyear | 
global RealAge,flag2 Perl »AQCost, Origin, 
global Graph 
if Origin is "Graph" then go back 
put empty into Graph 
1f Origin is “Optl" then put fid 
“Opti Values" into Graph 
if Origin is “Opt2" then put fld a 
"Opt2 Values” into Graph . 
if Origin is “Opt3" then put fld 
“Opt3 Values" into Graph 
SetUp. 
if not Flag2 then exit Units_Of ato 
put 0 into Total : 
Ask “Total units into the life of" is 
"this asset:" with field "Units" | 
if it is empty then exit Units_Of. Output 
put it into field "Units" 
repeat with x=1 to the number of — . 
lines of Graph | 
set cursor to busy 
put checkNum(item 1 of line x of - 
Graph / it * Book) into item 2 of — 
line x of Graph 
end repeat 
sy Origin is “Gptl” Chen put Graph - 
into fild "Optl Values" 
if Origin is "Opt2" then put Graph — 
into fld "Opt2 Values" : 
dif Origin is “Opt3" then put Graph — 
Wes fic “Opes Values” 
end Units_of_Output 


on Calculate 
global AssetAge,Life,Book,Lmonth, Fmonth 
globalFm,Lm,DepValues,Fyear,Lyear 
global RealAge, flag2,Perl, aatest 
global Origin,Graph 
Setup | 
if Flag2 is false then exit Calculate 
if RealAge <= 0 then . 
put 0.00 into fld "Depreciation" | 
put 0.00 into fld “Total Depreciation 
exit Calculate 
end if . 
if AssetAge > 50 then put 50 into — 
AssetdAge 
if RealAge < Fm then | 
put CheckNum(line 1 of DepValues * 4 
RealAge into fld “Depreciation” | 
put fld "Depreciation" into a“ . 
“Total Depreciation” _ 
exit Calculate 
ena tt. 
put 0 into Total 
/ repeat with x=0 to Assetige eT 
set cursor to busy 
| add line x + 1 of DepValues to Total 
end repeat : . 
get field “Dep Method" oe 
Th TE Es not Units of. Output" then 
i hue (heciha wee nen 
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Listing 1 - cont. 


f onth) / 12 into Fm i ittédi 
put max(0, Lear - Fyear) “into Assetage _ 
end Age 


on Grant. 
global Graph | 
if Graph. OT 
exit eran 
endif : _ 
set numberformat to 7 
put O tpto High : _ 
repeat with wri to the number of lines =_ 
of Graph |  . K< 
set cursor to busy  .. 
if line x of Graph > High | 
then put line x of ‘Graph into” High 
end repeat | | 
put the number of chars of - —. 
trunc(High) into Len : : 
put (char 1 of High + 1) * - 
10*(Len - 1) into High | 
repeat with x=1 to 10 
set cursor to busy . | 
put (High * x) / 10 into line - 
11 - x of fld "Value" . | 
end repeat 
repeat with x=1 to the number ao 
lines of Graph  . 
set cursor to busy __ : 
put trunc(69+(x*8)) into item i. | 
of line x of Graph2 — 
put trunc(243 - (Tine x of Graph [> 
High * 216)) . 
into item 2 of Vine x of Graph? 
end repeat 
ClearScreen — 
doMenu "Background" 
choose Line tool || 
repeat with x=2 to the number of 
lines of Graphe ss 
set cee pusy 


x of Graphe 
end repeat — . 
choose browse tool — 
end eraphit : 
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“When you have 
got an elephant by the 
hind leg, and he is 
trying to run away, 
it's best to let him 


) 


TUN. 


Listing 1 - cont. 


put QO into minuses 
repeat with curnum = 1 to length(Num) 
set cursor to busy 
if char curnum of num = "." then add 1 to decimals 
if char curnum of num = "-" then add 1 to minuses 
if char curnum of num is in "-1234567890." and— 
decimals < 2 and minuses < 2 then next repeat 
else | 
return “Error” 
exit CheckNum 
end if 
end repeat a 
if num = "."“ or num = "-" or num = ".-" or num ="-." theng | 
return “Error” 
exit CheckNum 
end if 
if Num < Q then put 0 into Num 
add zero to Num 
put round(Num * 100) / 100 into Num 
return Num 
end CheckNum 


Abraham Lincoln, 1865 


function ClickLine Type 
if style of target is “Scrolling” then _ 
put trunc((item 2 of the clickloc - the top of target —7| 
+ (scroll of target) / textheight of target) +1 into Lnyg 
else put trunc((item 2 of the clickloc - - . 
the top of target) / textheight of target) + 1 into Ln 
if Type is empty then return Ln 
else return line Ln of Target 
end ClickLine 


With Presidents, 
students will run straight 
into a wealth of information 
on 40 American Presidents. 


Using HyperCard™ 


facts on each president’s 
election, administration, 
political career, personal 
history, family, birth, death, 
quotes, and more are dis- 
covered through ten stacks 
of information. 

Presidents is an excel- 
lent resource for teaching 
history and political 
science. 


1MEG SIMMs 
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HyperCard not included 
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SQL Basics, Part 2 


—continued from page 12 


SELECT LAST_NAME, FIRST_NAME, 
COMPANY 

FROM CUST 

WHERE CUST_TYPE = ‘REG’ 

OR COMPANY = ‘Apricot Press' 
ORDER BY LAST_NAME; 


Multiple-Table Retrieval 


As you can see from what 
we've already discussed, SQL offers 
powerful data-retrieval capability. 
And we haven't really begun to ex- 
plore that subject in depth; for that, 
you need a book on SQL. There are 
several good ones available, but the 
best one I’ve found is Mastering OR- 
ACLE by Daniel J. Cronin, a senior 
Oracle technical staff member. 

Even if SQL could only retrieve 
information flexibly from a single ta- 
ble, it would be a wonderful exten- 
sion to HyperCard’s relatively limit- 
ed data-management capabilities. 
When it comes to combining infor- 
mation from two or more related ta- 
bles, ORACLE and SQL really shine. 

In what we have done so far, 
the delivery person in our deli 
would not necessarily know where 
to go to deliver an order because 
the CUST table doesn’t contain ad- 
dresses. Instead, it has only compa- 
ny names and, in some cases, build- 
ing numbers. Remember that we 
designed the table that way inten- 
tionally, so we could avoid storing 
duplicate addresses in the table. This 
data-space conservation is one of 
the major advantages of a relational 
database model like ORACLE. 

Let’s now assume that we’ve 
filled out the ADDRESSES table and 
that its contents are as shown in Fig- 
ure 3. Jerry Allen calls with an order 
for lunch, and we want to print the 
company name and address for the 
delivery person. Here’s how the SQL 
query would look (1’ll explain it 
shortly): 


SELECT LAST_NAME, FIRST_NAME, 
COMPANY, BUILDING, 
ADDRESSES.ADDRESS 

FROM CUST, ADDRESSES 

WHERE CUST.COMPANY = ADDRESS- 
ES. COMPANY 

AND CUST.BUILDING = ADDRESS- 
ES.BUILDING; 


(Notice that the ORDER BY 
clause has been eliminated because 
we expect this query to return only 
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ADDRESSES Table Contents 


Figure 4 
CUST_TYPE Table Contents 


one result and therefore need not 
sort the output.) 

Because we are working with 
two tables, we must tell SQL in the 
SELECT statement when we are in- 
structing it to extract data from a ta- 
ble other than the “main” one. We 
do this by appending the name of 
the secondary table(s) to the front of 
the name(s) of the column(s) to ex- 
tract and separating them by a peri- 
od. Thus the construction ADDRESS- 
ES.ADDRESS is interpreted by SQL to 
mean “the ADDRESS column from 
the table ADDRESSES.” In the FROM 
clause, the first table we list is as- 
sumed by SQL to be the “main” ta- 
ble to which it will default if we 
don’t give it a specific table name 
from which to select a particular 
column. 

The key to a multiple-table re- 
trieval—technically referred to as a 
JOIN operation in relational data- 
base terms—is the presence in both 
tables of a key field or fields that 
have common values. In most cases, 
this will be a single key field, but as 
you can see from our example, that 
need not be the case. In the exam- 
ple, we’ve used the equality of two 
separate columns as the basis for 
combining the information from the 
two tables. 

Here’s another example of a 
multi-table JOIN operation. This 
time, we’re using the contents of the 
CUST_TYPE table shown in Figure 4 
to produce a list that shows each 
customer’s name and type, where 
the type is spelled out rather than 
being displayed as a cryptic code. 
This is a common use of the multi- 
table retrieval technique. 


SELECT LAST_NAME, FIRST_NAME, 


CUST_TYPES.DEFINITION 
FROM CUST, CUST_TYPES 
WHERE CUST.CUST_TYPE = 
Gust bY Peo. CUST TYPE 
ORDER BY LAST_NAME; 


Notice here that the columns 
on which we are asking SQL to 
match the two tables—the 
CUST_TYPE column in each table— 
are not even among those we are re- 
trieving. This is perfectly permissible 
in a SELECT statement. Also note 
that although in our examples the 
corresponding columns in the two 
tables had the same names, this is 
neither necessary nor always desira- 
ble. The query above, for example, 
might be easier to read if we had 
chosen more uniquely descriptive 
names for our tables and columns. 


There’s Much More 


We have only scratched the 
surface of the capability of SQL in 
this series of quick looks at the lan- 
guage. Vast stretches of the lan- 
guage remain for you to explore on 
your own. But I hope that what we 
have been able to explore together 
has convinced you that SQL is a 
powerful language that can be used 
in conjunction with HyperCard’s 
great graphic interface, program- 
ming ease, and ease of use to pro- 
vide front ends to SQL-type databas- 
es. Insulating the deli owner from 
the necessity of learning and then 
typing all of these SQLcommand 
strings—and we have not really ex- 
plored some of the more complex 
ones she’d have to use to run the 
business well—is a great boon of 
HyperCard in this setting. 
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Speculation About a HyperCard Workalike from 
IBM Is Finally Answered... But How Does It Stack Up 


A Look at 


IBM LinkWay 


by Larry Burtness 


BM users have watched the growth in popularity of 
| HyperCard as a development system for informa- 

tion management applications and speculated on 
the adaptation of HyperCard for the IBM PC. IBM re- 
cently announced a product called JBM LinkWay that is 
billed as a hypertext tool for organization of informa- 
tion. It is capable of providing ways of linking informa- 
tion that is presented in text, pictures, video, and other 
forms. Although it is not a HyperCard clone, LinkWay 
brings many of the concepts and capabilities of Hyper- 
Card to IBM users. 

LinkWay will inevitably be compared with Hyper- 
Card, and although there are some similarities, there are 
also many differences. Here, we will explore some of 
these similarities and differences and provide you with 
an in-depth look at this new tool. 


LinkWay System Configurations 

LinkWay was designed with an eye toward memo- 
ry conservation throughout its development. The soft- 
ware requires, as the manual puts it, “the appropriate 
version of DOS for your computer,” a minimum system 
configuration of 384K of memory, a color graphics dis- 
play, an IBM or Microsoft compatible mouse controller, 
and at least one floppy drive. Because the majority of 
IBM PC’s and compatibles in use have 640K of RAM, 
most machines have the required memory to run the 
program. 

An optimum configuration for a PC running Link- 
Way would include 640K of memory or more, a hard 
disk, and an MCGA or VGA video graphics adapter (see 
Figure 1). These video displays provide good resolution, 
with up to 256 colors available on the screen. Other 
graphics configurations will also work, with LinkWay 
recognizing and using the highest resolution display that 
is available on the system when it is started up. If it is 


Larry Burtness is the Director of the Educational Technol- 


ogy Center for Educational Service District #189 in 
Mount Vernon, Washington. He specializes in training 
teachers to apply computers in education. He has been 
teaching HyperCard since its introduction, and using 
pre-release versions of IBM LinkWay for over a year. 
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Description: 

1 MB RAM 

10 MHz 80286 CPU 
Enhanced Keybrd 
3.0in. 1.44MB 

44MB Fixed disk 
YGA Display 
Serial /Parallel 
Mouse Adapter 


"#8560-041 
$5295.00 
& 


Figure 1 
Although LinkWay will run on any PC or compatible with a 
minimum of 384K of RAM, this LinkWay page shows a system 
ideally suited to running the new IBM LinkWay software. 


available, memory above 640K can be used as a RAM 
Disk to speed up operation of the system. 


IBM LinkWay Software Tools 

The JBM LinkWay system includes the LinkWay 
program and a number of utility files for accomplishing 
a variety of tasks. The LinkWay program is about 80K in 
size and provides the user with the overall operating en- 
vironment. This includes the ability to create and to exe- 
cute LinkWay application “folders,” the name given to 
LinkWay files. A LinkWay folder is roughly the equiva- 
lent of a HyperCard stack. The program works via an in- 
terface of pull-down menus, on-screen buttons, and 
pop-up menus, which are all mouse selected. 

Among the other utility programs and sample ap- 
plications included with LinkWay, are a paint program, 
a text editor, a font editor, and some demonstration 
folders such as a calendar and a “to do” list. 

The paint program, called LWPaint, is a simple 
painting program with basic drawing tools for creating 
and editing pictures. LWPaint works in any of the 
graphics screen formats supported by LinkWay, auto- 
matically using the screen format that matches your 
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computer’s hardware. The 
program can work with files 
created with PC Paintbrush 
(.PCX files) and LinkWay in- 
cludes a screen capture pro- 
gram called LWCapture that 
allows the capture of any 
screen into a file which is 
compatible with LWPaint and 
LinkWay. Incorporating 
graphic images into LinkWay 
applications can be accom- 
plished using a variety of 
paint programs, video image 
capturing boards, or scanners 
for the PC (see Figure 2). 

LWEdit is a text proces- 
sor that is included with the 
LinkWay system, and it can 
be incorporated as an inte- 
grated part of any LinkWay 
application. The editor may 
be used to display text files 
that contain resources for the 
application folder, or it may 
be used as a rudimentary pro- 
cessor for work by the appli- 
cation user. LWEdit is a basic 
word processor, lacking the 
features of more professional 
word processors. It does al- 
low easy text entry and edit- 
ing, margin formatting, simple 
block text moves and printing 
of documents from the appli- 
cation. In its current form, the 
editor is not mouse based, us- 
ing function keys to invoke 
the various features of the 
program, with a built-in help 
screen available at the press 
of the IBM’s F1 key. 

LWFontkd is a font edit- 
ing program that allows any 
of the font or icon tables for 
the LinkWay system to be edited 
and modified. The most common 
use of this will be to add custom 
icons to the icon file which applica- 
tions use. The editor is simple to 
use, allowing “fat-bit” style manipu- 
lation of pixels on the icon or font 
characters. 

Each of these utilities allows 
the application author to enhance 
LinkWay applications for specific 
uses without relying on other appli- 
cations. Separate, more powerful ap- 
plications can be used effectively in 
place of the provided applications if 
you wish. For example the popular 
paint programs Splash/, from Spin- 
naker, and Deluxe Paint II, from 
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| Info | 


Figure 2 


Paint graphics are stored externally and are read into 
LinkWay folders into user defined picture blocks. This 256 
color image was captured using a scanner. 


Create ™@ 
a Folder 


Ob jects 


Figure 3 


The basic organization of a LinkWay application and 
how it is developed is shown on this LinkWay page. 


Electronic Arts, work well for creat- 
ing and editing LinkWay graphics 
and offer far more features than 
LWPaint. 


LinkWay Data 


Organization 

Data organization in LinkWay 
is similar in many ways to Hyper- 
Card, however there are some major 
differences. Many of the differences 
are due to the nature of the video 
display on the IBM PC, with the 
overall data structure oriented 
around conserving memory space as 
much as possible. Features were left 
out in effort to keep the system as 


G7) 


small as possible. This 
memory saving allows the 
program to run using 
small capacity computers, 
and to run quite quickly 
for most uses. LinkWay 
cannot, however, hope to 
match all of the features 
of a program such as Hy- 
perCard, which weighs in 
at 380K plus. 

The information in 
the folder (See Figure 3) 
is organized on pages, 
similar to what Hyper- 
Card refers to as cards. 
The information that is 
placed on a page is in 
data fields, in buttons of 
various types, or in pic- 
tures. Each of these ob- 
jects has various attributes 
that dictate its appearance 
and function in the folder. 

The LinkWay folder 
is read from disk into 
memory when it is ac- 
cessed. The entire folder, 
less pictures and text doc- 
uments, must fit in memo- 
ry. LinkWay makes provi- 
sion for reserving memory 
space from 4K to 250K for 
folders, with memory that 
is left over available for 
running external applica- 
tions or utilities. If the in- 
formation to be stored in 
LinkWay folders is greater 
than 250K, it must be 
broken into separate fold- 
ers, with links established 
between the folders. Any 
number of folders may be 
linked in this way, so the 
actual data capacity is limited only 
by the size of the disk drive. 

HyperCard uses backgrounds 
to contain elements that are to com- 
mon to all cards in a stack, LinkRWay 
uses a “Base Page” to contains ob- 
jects that act in a similar way. But- 
tons on the Base Page are visible 
and accessible from all pages in the 
folder. Background fields in Hyper- 
Card act as unique fields on all 
cards in a stack, in LinkWay, howev- 
er, fields that are on the base page 
contain the same information on all 
pages. Thus, the most common use 
of fields on the Base Page in Link- 
Way is as an identifying label, and 
they are not appropriate for data 
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that is changed from page to 
page. 

Unlike HyperCard 
where a picture layer is part 
of the card, pictures in Link- 
Way are not stored as a part 
of the page on which they are 
displayed. They are stored in 
separate picture files, and 
read from the disk when they 
are required for display. Pic- 
tures are placed on the page 
in a layer below the fields and 
buttons on the page, so the 
fields and buttons appear on 
top of a picture. 

Pages are assigned ID 
numbers as they are created 
in any particular folder, begin- 
ning with 1 and counting up- 
ward. ID numbers are always 
unique within a folder, and 
are not repeated, even if a page is 
deleted. In addition to an ID num- 
ber, each page is assigned a se- 
quence number, which is the or- 
dered position of the page in the 
folder. The sequence number may 
change as new pages are added to, 
subtracted from, or moved around 
within the folder, but the ID number 
remains permanent. Both ID and se- 
quence numbers can be used as des- 
tinations of links within the LinkWay 
system. LinkWay assigns unique ID 
numbers only within a folder, not 
across folders. The ID number of the 
Base Page of any folder is always 
zero. 

Objects that are placed on a 
page in LinkWay are placed in char- 
acter-mapped positions (every 8 pix- 
els), rather than bit-mapped posi- 
tions as in HyperCard. This allows 
Fields, Buttons, and Pictures to be 
placed only on character location 
boundaries, not pixel by pixel. This 
simplification in the system allows 
for somewhat less flexibility for 
some requirements, but makes the 
on-screen alignment of objects easy. 


Five Different Access 


Levels 

User access to LinkWay folders 
is controlled by a password protect- 
ed access level assignment. The as- 
signment levels are Read, Update, 
Insert, Delete, and Format. Creating 
and editing objects in a folder is 
possible only when the access level 
of a folder is set to Format. A Read 
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When buttons are clicked, the 
action associated with that 


button takes place. 


There are seven types of 


LinkWay buttons. 


Buttons may be displayed, as 
those on the left, or they 


may be invisible. 


Figure 4 


This screen displays the seven button types available 
within a LinkWay application. 


level access allows read-only access, 
data is not modifiable by the user. 
Update access allows fields that are 
not locked to be changed. Insert and 
Delete access levels refer to the abil- 
ity of the user to.add or remove 
pages from the folder. Developers 
who are distributing application 
folders for LinkWay can provide the 


level of access that is ap- 
propriate for the 
application. 


Buttons 

Buttons in LinkWay 
are used in a fashion simi- 
lar to those in Hyper- 
Card—as the operative 
objects for controlling the 
functions of the applica- 
tion. There are seven dif- 
ferent types of buttons, 
each having a different 
use (see Figure 4). By 
carefully employing the 
different types, many ap- 
plications can be devel- 
oped without any 
scripting. 

The button types are 
Go, Link, Find, Text pop-up, Picture 
pop-up, Script, and Document. The 
only one that allows the author to 
write script code is the Script type, 
all others have built-in functions that 
the author assigns from a series of 
menus and dialog boxes as the but- 
ton is created. 

HyperCard uses a separate tool 
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256K SIMMs 
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@ Prompt Delivery 
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Computer Product Center 


1-800-365-SIMM 
Call Today! Get Off the Memory Waiting Lists! 


4410 Stamp Rd., Suite 200 
Temple Hills, Maryland 20748 


for each type of object, but 
LinkWay does not differen- 
tiate between the creation of a 
Button, Field, or Picture ob- 
ject. All are created from the 
same pull down menu, using 
the same techniques. 

When you create a new 
button, you select the Object 
menu, pulling down to the 
“New” option. An on-screen 
pop-up menu allows you to 
select the object type to be 
created, either a Button, Field, 
or Picture. After the type is se- 
lected you drag the object to 
the desired position and size. 

After positioning the 
button, the Button type is se- 
lected from a menu of the 
seven different types. After se- 
lecting the button type, a dia- 
log box asking for the button 
name appears, this is optional 
and may be passed by, or you 
may enter a name up to eight 
characters in length. 

A dialog box for select- 
ing the desired icon to be 
used is then displayed. You 
have a choice of 96 different 
icons, and they may be modi- 
fied as desired using the 
LWFontEd program. 

After selecting the icon 
for the “Go” button, you se- 
lect the destination—either 
Base, First, Last, Next, or Pre- 
vious—from an on-screen 
menu. You create each object 
in a similar fashion selecting 
its parameters and attributes. 


Barite is more frequently 

often colored orey or blue 
South Dakota are US sour 
about $ em lona, 


Barite 


Barite is more frequently found as plates, 
often colored grey or blue-grey, Colorado and 
South Dakota are US sources, The sample is 
about 8 cm lons, 


eared 


Figure 5 


This screen shows how the combination of colored text 
and graphics make LinkWay ideally suited to education. 


Barite 


Barite is the mein. 
is 

used to absorb rad- 

lation in special 


ore of barium. 
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Figure 6 


Pressing on the “Uses” button above, brings up a Text 


pop-up field with added information. 


Scripts in Script 
Buttons Only 


Script buttons allow the author 
of a folder to create buttons for spe- 
cial purposes, programming in a 
simple scripting language. The lan- 
guage is different from HyperTalk, 
the language of HyperCard, and 
does not contain as many features 
and functions. See the “Table of 
LinkWay Script Statements” at the 
end of this article for a list of all 
built-in scripting commands. 

The language allows program 
structuring through the use of 
IF...ELSE statements, and jumps to 
labeled locations in a script. There 
are no Repeat statements, but these 
may be created using a combination 
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of IF...ELSE statements and counter 
variables. Page to page or folder to 
folder links, finds, cutting and past- 
ing of pages, printing and other 
script statements allow the script 
programmer to control the access to 
pages in folders under script control. 

The script programmer can 
provide interaction with the user 
through input statements, prompting 
messages, and pop-up on screen 
menus through script statements. In 
addition, data can be read and writ- 
ten to and from disk files. 

The scripting language allows 
for the execution of any DOS com- 
mand from within a script, as well as 
the extension of the system through 
the use of external routines. 


drunk 
prior to receiving 
A intestinal X-rays. 


Special Button 
Types 


There are two spe- 
cial button types that do 
not exist in HyperCard, 
the text pop-up and the 
picture pop-up. The text 
pop-up allows you to 
place a button on a page 
that pops-up to become a 
small scrolling text win- 
dow (see Figures 5 and 
6). This can contain up to 
3000 characters of text 
with scrolling controls 
similar to scrolling fields 
in HyperCard. A similar 
function can be set up in 
HyperCard using a button 
to control a scrolling field 
on a card, using Hyper- 
Talk’s show field com- 
mand. LinkWays pop-up 
text buttons are easier to 
implement than the 
equivalent in HyperCard, 
however, the HyperCard 
scrolling field is capable 
of holding much more 
data, 32K versus 3K. 

Picture pop-ups are 
similar to text pop-ups ex- 
cept that a part of a 
graphics picture is placed 
on the page, rather than a 
field of text. The picture 
may be a piece of a larger 
graphic produced by a 
paint program or a scan- 
ning system. The picture 
may be re-sized and re- 
positioned on the screen 
as desired. Using exten- 
sion programs to LinkWay, which 
are a part of the LinkWay Toolkit, 
the pop-up Picture may be an ani- 
mation sequence as well. Pop-up 
pictures are not a part of HyperCard, 
but have been implemented as 
XCMD’s. Implementation of this type 
of action in HyperCard without the 
use of an external command re- 
quires a change to a second card 
with the pop-up picture on itt 

A document button is also a 
unique button type that has the ex- 
press purpose of invoking the docu- 
ment editor, LWEdit. This editor is 
capable of loading and editing files 
that are up to about 25K in size. 
Document buttons can be brought 
up with text files already in them, or 
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with the editor empty, ready for the 
users text entry. These can be used 
for providing supplementary text in- 
formation to the on-screen fields 
and other data in the folder 

The document text files are 
stored outside of the LinkWay fold- 
er, just as pictures are. They do not 
add to the size of the folder, but do 
require disk storage space. They can 
be very helpful in allowing docu- 
ments to be accessed quickly from 
within LinkWay, for example, to 
place a text file containing the docu- 
mentation of an application directly 
in the application by the inclusion of 
a document button for the docu- 
mentation file. 


Fields for Data 


Fields in HyperCard can have 
many different forms and visual at- 
tributes. Fields may also have Hy- 
perTalk scripts associated with them 
that can cause the field to perform 
some programmed operation. In 
LinkWay, fields can be set up to 
hold text or numeric data, but the 
on-screen visual attributes that can 
be controlled are fewer. They in- 
clude the size and screen placement 
of the field, the color of the text, 
and the size and style of the font 
used in the field. 

LinkWay fields cannot have 
scripts that are directly held by the 
field. This can be implemented in 
LinkWay by placing an invisible 
Script Button over the top of the 
field that refers to the field in its 
script. Script buttons are the only 
objects in LinkWay that can contain 
script code. Any object in Hyper- 
Card can have a HyperTalk script 
associated with it. 


Running Other 
Applications From 
LinkWay 


LinkWay has a number of pro- 
visions for extending the capability 
of the system and running other ap- 
plication programs from within a 
LinkWay folder. There are three sep- 
arate ways to run external programs, 
each with different purposes and 
each increasing the power of Link- 
Way for custom applications. Some 
of these are similar to the way in 
which HyperCard is extended using 
XCMD’s. 
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Assembler or binary routines 
for specific tasks can be run from a 
LinkWay script button. Programmers 
familiar with techniques of assembly 
programming can use this capability 
to create specific drivers or special 
adaptations. 

In addition, LinkWay has pro- 
vision for running a custom subrou- 
tine written in C or some other sys- 
tem programming language. The 
external routine can pass data to 
and from LinkWay folders, even ac- 
cess the data pages in a LinkWay 
folder directly. This kind of access 
should only be attempted by experi- 
enced programmers, because data in 


the folder can be destroyed if it is 
done improperly. This capability 
does allow LinkWay applications to 
be developed well beyond the na- 
tive capabilities of the system, and 
should be of great interest to devel- 
opers of applications. 

In addition to being able to 
run user-written assembler and other 
routines, LinkWay has the capability 
of running any DOS command by 
using a DOS “shell.” Any application 
that is run under DOS should be 
able to be run from LinkWay as long 
as it fits in the available memory. 
This can be used for a number of 
different purpose. 


Educators- 
Stack your deck, join ICCE. 


The Intemational Council for Computers in Education 
is dedicated to the improvement of education 
through technology. 


The International Council for Computers in Education Is the largest 
professional membership organization for computer educators at the 
precollege level. Founded in 1979, and housed at the University of 
Oregon, ICCE Is nor-profit, supported by 12,000 individual members and 
over 50 organizations of computer-using educators worldwide. 


Members of ICCE receive a subscription to The Computing Teacher, 
and the Update newsletter, discounts on ICCE books and courseware, 
Independent Study Courses, and Special Interest Groups. 


The Computing 
Teacher journal 
Published eight times 
a year, The Computing 
Teacher provides the 
latest practical and inno- 
vative information in 
computer education 
and application for 
educators, administra- 
tors, computer coordina- 
tors and teacher 
educators. The Comput- 
ing Teacher contains 
feature articles, columns, 
software reviews, and 
new product announce- 


Courses 


Books 


independent Study 


ICCE offers graduate- 
level Independent study 
courses, designed to 
provide staff develop- 
ment and leadership. 
They are approved by 
the College of Education coordinators,Logo-using 
at the University of 
Oregon, and carry 
graduate credit from the 
Oregon State System of 
Higher Education. 


Special Interest Groups 


ICCE supports several 
SIGs for computer-using 
educotors , providing in- 
depth information to 
computer science 
educators, computer 


educators, ESL teachers, 
and teacher educators. 


ICCE is a wealth of 
information. 


For information and a 
current catalog contact: 


ments. 


Update Newsletter 
Update features 
information about ICCE 
activities and Its organ- 

izational members. 
Included Is national 
legislation information, 
“What's New," and a 
conference calendar. 


and Courseware 

ICCE has a Wide 
variety of books and 
courseware. Titles 
include AppleWorks for 
Educators, MSWorks for 
Educators, Teaching 
Thinking Skills with 
Databases, Presidents, 
World Data, and many 
more. 


University of Oregon 
1787 Agate St. 
Eugene, OR 97403 
(503) 686-4414 
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page ‘into folder from a disk file 


A) teeth image of the current page 
os screen on page change 


Video Display Modes 

One of the difficulties of creat- 
ing application programs for the 
IBM PC comes from one of the 
strengths of PC’s and compatible 
systems—the diversity of video dis- 
play modes available. There are col- 
or graphics display modes available 
in many resolutions and capacities, 
for any need and any budget. Link- 
Way supports all of the color display 
modes used by IBM on its personal 
computers, including 4 color CGA 
(320 X 200 pixel), 16 color EGA and 
VGA (640 X 400 pixel), 256 color 
MCGA (320 X 200 pixel), and High 
Resolution Monochrome (640 X 400 
pixel). The program recognizes the 
highest display mode your system is 
equipped with and attempts to use 
that display. 

Converting applications from 
one mode to another is quite easy, 
file extensions are changed to reflect 
the new mode desired, and the fold- 
er is opened using the new display 
mode. LinkWay automatically con- 
verts the folder to the new display 
mode. Some object placement will 
not be exact, especially in changing 
from 320 X 200 to 640 X 350 display 
modes, so some editing of object 
positions may be necessary, but the 
folder remains fully functional. 


Special Features 

LinkWay provides capability to 
- access a number of special peripher- 
al devices, as well as the normal re- 
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sources of the computer. The script- 
ing language includes the SERIAL 
statement allowing access to the se- 
rial port for communications or con- 
trol of devices such as laser video- 
disc players. Folders with videodisc 
related data and interactive control 
are relatively easy to create and pro- 
vide exciting possibilities. 

Special applications using IBM 
InfoWindows displays, IBM speech 
options, music options, and other 
peripheral hardware are also possi- 
ble. The main IBM marketing efforts 
for LinkWay thus far are in the kin- 
dergarten through twelfth grade edu- 
cation area, and the versatility of ap- 
plications using these special 
devices is particularly suited for edu- 
cational applications. 

The LinkWay Toolkit, available 
from Washington Computer Servic- 
es, is a special set of routines to be 
used with LinkWay to extend its ca- 
pabilities. The Toolkit contains a 
number of binary routines that are 
used as drivers to control special de- 
vices or operations. In addition, the 


. box on the screen 
ine at bottom of screen 
enu on the screen 
input: from keyboard 


Toolkit contains a number of extra 
fonts for the system, and routines for 
graphics, animation, and speech, 
with sample LinkWay application 
folders. 

The arena of graphic, object 
oriented applications is a growing 
one, with several products either 
available now or on the horizon. 
LinkWay is a first release by IBM 
into this application area. The pro- 
gram was designed to provide a 
data organization tool that applies 
hypertext principles, runs on any 
PC, provides access to color graph- 
ics and other functions of the IBM 
PC, and is easy to use. Many Hyper- 
Card applications can be duplicated 
in function using LinkWay, and sev- 
eral developers are working on ad- 
aptations of HyperCard applications 
into the IBM world. Several sample 
applications are provided with Link- 
Way which illustrate some of the 
possibilities, and it is only a matter 
of time until we see the same pro- 
liferation of applications as are cur- 
rently available for HyperCard. 
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Overriding HyperCard’s Message-Passing Scheme 


by Dan Shafer 


the message-passing hierarchy. By taking 

advantage of this capability, you can write 
HyperTalk scripts and handlers that are as generic as 
possible and, therefore, reusable. Code reusability is one 
of the key ideas in the current software engineering rage 
known as object-oriented programming because of the 
tremendous gains in efficiency it brings to programmers. 

Just so we’re sure we’re all starting at the same 

point, let’s quickly review the message-passing hierar- 
chy. Then I'll talk a little about reasons and methods for 
overriding this normal message-passing scheme. 


@) ne of the most powerful ideas in HyperCard is 


The Norm 


Left to its own devices, HyperTalk receives any 
message at a default location in the hierarchy shown in 
Figure 1 and passes it up the chain until one of two 
things happens. Either a handler with the same name as 
the message is found and the message is interpreted 
into actions, or the message reaches the top level of the 
hierarchy. If a system message reaches the top level of 
the hierarchy, HyperCard simply tosses it away. But if a 
user-defined message gets that far without being han- 
dled, an error is generated. 

If you’re skeptical — or if you just need a concrete 
demonstration of abstract ideas before you can own 


Listing 1 


on mouseUp 
send “ope nCard” 


end mouseUp 


Listing 2 
on mouseUp 
send "openMind” 


end mouseuUp 


Dan Shafer is the author of many microcomputer books, 
including the newly released HyperTalk Programming 
(including version 1.2), and Understanding HyperTalk 
(both from Hayden Books). 
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Each level in the 

hierarchy pop 
messages higher 
or deeper, in the 

direction of 

the arrow 


Background Script 
Card Script 


Message Box 


Primary Sources of Messages 


Figure 1 
This diagram, taken from Chapter 5 of HyperTalk Program- 
ming (including version 1.2) by the author, demonstrates the 


basic message passing hierarchy in HyperCard. 


them — you can prove the accuracy of this statement by 
writing two one-line button scripts. The first, shown in 
Listing 1, generates a system message using the send 
command that we'll spend more time on later in this 
column. The second (Listing 2) is exactly the same, 
except this time we’ve defined a message that is not in 
the system’s vocabulary. Pressing the first button has no 
visible effect; the message is simply ignored. But press- 
ing the second generates an error message: “Can’t 
understand openMind.” 


Message-Eating and Passing 


There are occasions on which you wish to over- 
ride this normally useful message-passing scheme imple- 
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mented by HyperCard. When you 
wish to do so, HyperTalk thought- 
fully provides two commands to 
enable you to defeat its standard 
behavior: pass and send. 

Recall that when a message 
encounters a handler that bears its 
name, it executes that handler and 
then essentially disappears from the 
message-passing hierarchy. Gener- 
ally, this is what we want—one mes- 
sage, one handler. But you’ve prob- 
ably made the mistake U know I 
have!) of intercepting a message 
with a handler and then experienc- 
ing bizarre behavior as a result. For 
example, the doMenu message is 
often used to disable or confirm cer- 
tain user actions. Listing 3 shows an 
example of a typical use of the 
doMenu command. 

This handler does exactly what 
you intend: Confine the user to the 
current background even when 
“Next” or “Prev” are chosen from the 
HyperCard “Go” Menu. But if you 
implement that handler and then try 
do something unrelated to the “Go 
Next” or “Go Previous” menu com- 
mand, you’re in for a surprise. None 
of the other menu items work at all 
(except, it turns out, tool selection, 
which bypasses the doMenu com- 
mand in HyperCard 1.2.2, I under- 
stand this anomalous behavior is 
changed in a future release). Why? 
Because you’ve built a handler to 
intercept the doMenu system mes- 
sage and that handler has taken care 
of the user’s menu choice by deter- 
mining if it is one it should handle. 
If it is, it carries out the commands 
in the handler. If not, it simply “eats” 
the command. 

If you want to leave other 
menu options enabled, you must 
add a pass command at the end of 
the handler, as shown in Listing 4. 
Notice that we simply pass the com- 
mand, not its associated parameters. 
HyperCard takes care of the parame- 
ters in a paSS command as it passes 
the entire operation string that ini- 
tiated the message in the first place. 

The pass command is often 
helpful in implementing HyperCard 
stacks efficiently. It enables you to 
define groups of objects, such as 
buttons, that have some common 
functionality, but also some unique 
capabilities or requirements of their 
own. Listings 5 and 6 represent two 
hypothetical HyperCard buttons 
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Listing 3 


on doMenu what 
if what is "Prev" then go previous card of this - 
background _ 


if what is "Next" then go next card of this background 


end doMenu 


Listing 4 


on doMenu what 


if what 1s "Prey" then go previous card of this — 


background 


if what is "Next" then go next card of this background 


pass doMenu 
end doMenu 


Listing 5 


on mouseUp -- script for hypothetical button 2 
open file “Smalltalk Advantages” 
read from file "Smalltalk Advantages” — 
until numToChar(26) -- EOF marker 
put it into field “Language Pluses” of card "Smalltalk" 
put the number of lines of it into totalLines 


play “harpsichord” cs f a 
push this card 


visual effect zoom open slowly to black 


go to card "Smalltalk" 


put “Here are the” && totalLines && -— 


"advantages of Smalltalk.” 
wait until the mouseClick 
pop card 

end mouseUp 


Listing 6 


on mouseUp -- script for hypothetical button 2 
open file “HyperTalk Advantages” 
read from file "HyperTalk Advantages” until — 


numToChar(26). ee EOF marker 


put it into field "Language Pluses” of card "Smalltalk" 
put the number of lines of it into totalLines 


play “harpsichord” cs f a 
push this card 


visual effect zoom open slowly to black 


go to card “"HyperTalk" 


put “Here are the” && totalLines — 


&& “advantages of HyperTalk.” 


wait eet) the mouseClick 
pop card 
end mouseUp — 


Listing 7 


‘on mouseUp -- revised script for button 1 


global totalLines, language 


open file "Smalltalk Advantages" 
read from file "Smalltalk Advantages" until — 


numToChar(26) -- EOF marker 


- put it into field "Language Pluses" of card "Smalltalk" 
put the number of lines of it into totalLines 


put "Smalltalk" into language 
pass eo oS 
end mouseUp — 


whose scripts obviously have some 
overlapping requirements in the 

final three lines. With only two but- 
tons, this situation is at least tolera- 


ble (though duplicating the function- 
ality is still not good design), but 
what if you had 10 or 15 such but- 
tons? The resulting wasted stack 
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space for common scripts could 
obviously be saved by judicious pro- 
gramming. Listings 7 and 8 show 
these two button scripts reduced to 
their unique requirements, although 
Listing 9 shows a script that would 
appear higher in the HyperCard 
hierarchy (probably at either the 
card or background level, depend- 
ing on where the buttons “live”) to 
supply the common function. Notice 
that we have gone from two han- 
dlers of 12 lines each (24 lines of 
code discounting open and end 
statements) to two 7-line handlers 
and one 8-line handler (22 lines of 
code). This saves only two lines, but 
the fact that it saves lines at all when 
consolidating only two similar han- 
dlers demonstrates the power of the 
idea. If we had, say, 15 program- 
ming languages to compare this 
way, we would go from 180 lines to 
113, a savings of 67 lines, or 37% in 
code space. When scripts are limited 
to 30,000 characters, savings like 
these can be important. 

Beyond code savings, the reus- 
ability of the resulting code is 
immensely improved. The handlers 
in Listings 5 and 6 can only be 


The HyperHIT™ 
Macintosh software package 
adds a set of commands to 
HyperCard that allow the 


or ISAM files. 
Anyone who has dealt 


to HyperCard knows that the 
promise of HyperCard as a 
serious database is severely 


for records by key. As fast as 


that bogs down as files get 
larger and larger. 


10) ap CREAM 


RNATIONAL IN 
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developer to make use of keyed 


with the sluggish file I/O native 


limited by its inability to search 


the text search capacity is, even 


Listing 8 


on mouseUp ae revised script for button 2 


global totalLines, language © 


read from file "Hypertalk Advantages” until — 


numloChar(26) -- EOF marker 


put it into field “Language Pluses” of card "iyperTalk" 
put the number of lines of it into totalLines” og 
put “HyperTalk™ into language 


pass mouseUp 
end mouseUp 


reused in the sense that they can be 
copied, pasted, and modified by 
editing. The combination of the han- 
dlers in Listings 7-9, on the other 
hand, produce a single handler (List- 
ing 9) that can serve for any subse- 
quent buttons we add for other lan- 
guages where the same functionality 
is needed. 

As is often the case, HyperTalk 
provides a number of ways of 
accomplishing this consolidation of 
common functions. The pass com- 
mand is one way. You could also 
define a message called something 
like goCard and put it higher in the 


HyperHIT Database Engine $195.95 


HyperH IT extends the 
power of HyperCard by 
creating structured files that 
can be randomly searched in 
fractions of a second. 
HyperHIT converts HyperCard 
into a serious database engine. 

The HyperHIT commands 
are a set of function calls 
useable from any standard 
HyperTalk program. A clearly 
written manual shows how to 
use each command and each 
command ’s effects. Sample 
programs are supplied as well 
to show the combination of 
commands in action. 


This product is aimed at any developer who needs the power and speed of 
keyed files inside the user-friendly context of HyperCard. It will put 
unparalleled power into the hands of HyperCard programmers. 


Price $195.95 + 1-800-262-6610 + 609-866-1187 
SoftStream International, Inc. 

19 White Chapel Drive - Mount Laurel, NJ 08054 

Both Site and Developer Licensing Available 


hierarchy, then call it from the 
mouseUp handlers in Listings 7 and 8 
rather than passing the mouseUp. 


You Send Me 


If the pass command allows 
us to gain considerable efficiency 
and reusability of our HyperTalk 
code, the send command adds an 
order of magnitude of power to the 
concept. The pass command has 
two inherent limitations. First, it can 
only pass the currently executing 
command. Second, it can only pass 
that command to the next level of 


Keyed searches are very 
fast because they search among 
a relatively small, pre-sorted 
set of keys, rather than through 
the whole file. Therefore, if you 
are looking for one or more 
entries in a list keyed on a 
particular zip code, the 
commands find that key very 
quickly, and go from there to 
the exact address of the record. 
On a hard disk, this HyperHIT 
search takes considerably less 
than a second, no matter how 
many records and keys there 
are in the database. 
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Listing 9 


Listing 10 


Listing 11 


Listing 12 


the pre-defined HyperCard 
hierarchy. 

Sometimes, we want or need 
to send some message other than 
the current one to an object at the 


same level of the hierarchy or lower. 


When that is the case, we can use 
HyperTalk’s send command. The 
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send command lets us transmit any 
message—system or user-defined— 
with or without parameters to any 
other specifically addressable object. 
Its power is immense. 

You should be careful in using 
send because it can often become a 
way of building and excusing poorly 


designed code. The send command 
should only be used when it makes 
the code smaller, easier to follow, 
and more straightforward to reuse. 

Two circumstances that war- 
rant consideration of the use of the 
send command are: 


e When you want to bypass inter- 
mediate handlers between the cur- 
rent object and the desired 
handler 

e When an object at this or a lower 
level of the hierarchy has exactly 
the code you want to execute and 
you want to avoid duplicating it 


Listings 10, 11, and 12 demon- 
strate a trivial but illustrative exam- 
ple of the first situation. Here, we 
have three different sound effects, 
one at the button level, one at the 
card level, and one at the stack 
level. Sometimes, we want to play 
all of the sounds. Other times, we 
want to play only one or two of 
them. The button handler in Listing 
10 takes care of the situation nicely. 

In my calendar (I use Orga- 
nizer+ from Dazzl Software for my 
schedule), I have a number of han- 
dlers that perform special functions 
such as looking for information that 
should be exported. When one of 
these special handlers finishes exe- 
cuting, I want to go back to today’s 
schedule card. I could use a series 
of push and pop statements to keep 
track of card travel, but I find that 
messy, particularly if I’m doing a lot 
of jumping around in the stack. But 
the stack includes a button labeled 
“Today” that returns me to today’s 
card. This button must do some 
intelligent maneuvering because it 
can’t just simply look for today’s 
date. (The date may appear in a 
number of places in the stack, for 
example, in my To Do list.) Rather 
than repeating this code everywhere 
I want to go back to today’s date, I 
simply use the command: 


send mouseUp to background = 
button "Today" 


and let the button script take 
care of the problem for me. 
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Creating Easy to Use Control Devices in HyperCard 


by Craig Ragland 


device (the mouse) have led many software 

developers to explore mouse-driven controls and 
dials. We technological humans are accustomed to con- 
trolling machines through direct manipulation of 
switches, knobs, and sliding controls, so these simulated 
or virtual controls feel quite natural. If a screen-based 
control is graphically familiar and behaves in the same 
manner as its real-world counterpart, it is trivially easy 
to learn and use, even for naive computer users. 

HyperCard and SuperCard both offer excellent 

environments for exploring these types of user inter- 
faces. Although the performance of interpreted Hyper- 
Talk on slower Macs may be inadequate for some con- 
trols, it suffices for many and is certainly acceptable for 
prototyping. In this column, we shall explore three 
types of controls: toggles, knobs, and sliders. None of 
these are directly available in the standard HyperCard or 
SuperCard interface (except in the simplified case of the 
standard Apple check boxes and radio buttons). All 
three of these require the tight integration of graphic 
objects and clever scripting. 


Toggles 

The standard Apple check boxes and radio buttons 
are graphically simple examples of toggles or switches. 
According to Apple’s guidelines, Check Boxes are 
intended to be used to let users choose among alterna- 
tive options. Check boxes toggle between two states: on 
and off. If the box is checked, the option is on; other- 
wise it is off. Check boxes should also function indepen- 
dently from each other—in groups of check boxes click- 
ing on one has no effect on the others. 

HyperCard developers not understanding the 
check box interface guidelines (or choosing to ignore 
them) have used check boxes for menu selections, close 


T: Mac’s graphic interface and flexible pointing 


Craig Ragland is a principal with INTERACTIVE DESIGN, 
a Seattle-based Hypermedia development company and 
can be reached at 206-542-9000. INTERACTIVE DESIGN 
created 101 Scripts & Buttons for HyperCard a collec- 
tion of HyperCard interface extensions published by Indi- 
vidual Software: 800-622-9986. 
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boxes, navigational links, and to initiate operations 
(sorts, finds, printing, etc.). In general, if an action 
begins immediately following a click on a check box 
button, other than making more options visible, it is 
inconsistent with the Apple guidelines. 


If a screen-based control is 
graphically familiar and behaves in 
the same manner as its real-world 
counterpart, it is trivially easy 
to learn and use, even for naive 
computer users. 


As pointed out in last issue’s “Interfacing the 
Future” column, according to Apple guidelines radio 
buttons are intended to be mutually exclusive—only 
one in a group is on and clicking on any other radio 
button in a group turns the other one off. [See Hyper- 
Link Magazine Vol. 2, No. 2—Ed.] This guideline has 
likewise been ignored by numerous HyperCard devel- 
opers. The small size and strong visual/tactile appeal of 
a highlighted radio buttons have resulted in their wide- 
spread use for a number of different functions. for 
example, one interesting user interface guideline “viola- 
tion” used radio buttons to mark towns on a hierarchical 
set of maps. 


‘Before: []Auto hilite 


After: Q)auto hilite © radi 
Figure 1 

Behavior of normal check boxes and radio buttons when the 
user mouses down on the button. This is not true of HyperCard 
buttons (except those in HyperCard’s dialog boxes). 


HyperCard check box and radio buttons behave 
slightly differently from those in other applications (or 
even in HyperCard’s own dialog boxes). In most appli- 
cations, mousing down on either a check box or radio 
button emboldens that button while the mouse is held 
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down (see Figure 1). This provides 
user feedback on the user’s choice 
before the action has been 
completed. 

The disadvantage of using 
these standard interface items in 
ways which are different from the 
Apple guidelines are really only per- 
tinent when Mac-literate users will 
be using your stacks. If you design 
stacks for naive end users, there are 
no particular reasons you should fol- 
low the Apple guidelines. There is 
nothing embedded in the graphic 
image of radio buttons or check 
boxes that suggest how they should 
function when they occur in groups. 
The guidelines for the behaviors of 
these interface items, like many oth- 
ers are really rather arbitrary conven- 
tions which add to the consistency 
of Macintosh software as a whole. If 
your stacks will be used by Mac- 
naive users you have fewer con- 
straints over the interfaces which 
you design. 


Extending HyperCard 


Buttons 

More complex (and visually 
interesting) toggles or switches can 
be created using graphic objects 
along with associated scripts. In 
HyperCard the graphic objects can 
be created as ICONs or FONT char- 
acters. SuperCard allows even 
greater flexibility because paint 
frames and draw-type graphics can 
be independently manipulated. Fig- 
ure 2 shows several toggle switches 
from Individual Software’s product 
101 Scripts & Buttons for HyperCard 
(created by the author). The scripts 
for these buttons use an ICON flip- 
ping animation technique to simu- 
late the real world version of the 
object. The script for toggle button 
#1 is in Listing 1 and the script for 
toggle button #7 can be found in 
Listing 2. 

There is a very wide range of 
other toggles and switches. It is not 
terribly difficult to simulate almost 
any form of two phase switch (some 
examples you might try include bat 
switches, light switches, sliding tog- 
gles, etc.) An extensive and spectac- 
ular collection is found in “Stack- 
Starter” by Robertson Smith. 
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ny’ Does it Wark? 


Click on the buttons to toggle them 

between the two values. Some of them fr 
have a transitional step between the two [fii 
endpoints. 


Figure 2 
This is the card devoted to Toggles from 101 Scripts & Buttons for HyperCard showing 
several different ICON based toggle switches. The script for toggle button #1 is in List- 
ing 1, and the script for toggle button #7 is in Listing 2. 


Listing 1 - Script for Toggle #1 in Figure #2 


On mouseDown 
| == ICON Resources used: 1D# 18752: "ScuarePiain", 
-- | ID# 16918: “SquareGray” 
if icon of me = "18752" then : 
set icon of me to oe 
play boing cés 
set name of me to “ON” 
-- Put code for what happens when button is "Gray" 
-- or "ON" here. 
| else 
set icon of me to "SquarePlain” 
play boing e2s 
set name of me to “OFF" 
-- Put code for what happens when button is 
-- “White” or “OFF” here. 
end if 
end mouseDown 


Listing 2 - Script for Toggle #7 in Figure #2 


Op ‘Mousevown | 
~ ICON Resources used: ID# 6237: "“RWhiteS” 
_ IDF 10677: “LWhites” 
aif the mouseH < item 1 of loc of me then 
set icon of me to “RWhiteS" 
set name of me to "ON" 
-- Put code for what happens when switch 
-- 1§ turned nw here. 
else 
set. icon of me to “LWhites”. 
Set name of me to “OFF” oe eo 
Put code for what happens ven switch : 
is. turned Orr here. 
end +f _ 
ene mouseDown / : 


‘on mousestt 1 Down 
iW ve mouse oc as within rect ot me ‘then ‘send - 
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Figure 3 
This is the card devoted to Knobs from 101 Scripts & Buttons for HyperCard showing 
several different ICON based Knobs. 


Listing 3 - Script for Knob #1 in Figure #3 


on mouseDown 
send mouseStil}]Down to me 
end mouseDown 


on mouseStilldown |  . 
if the mouseLoc is within rect of me then _ 
~~ Create 11st of [CONS to use, since a disco 
~~ subset of all the “Dial.” ICONs are used. 
This button uses the following ICON oe 
-~ [O# 11962: “Dial.2", [DF 834: “Dial 4° : 
~- [OF 30117: “Dial.6". [0% 4264: “Dial .s" 
put “2,4,6,8" into iconList 
= Compute difference between _— and button 
put (item 1 of the mouseloctl) - 
(item 1 of loc of me) into deltaX 
put (item 2 of loc of me) - = . 
(item 2 of the mouseloct+l) into deltaY 
-- deltaY/deltaX = Tangent of angle from 
-- knob loc to mouseloc. 
put deltaY/deltaX into t 
put atan (t) * 57.29578 into d . 
-- Convert differences into degrees, then determine 
-- the appropriate position number (posNumber). | 
if deltaX < 0 then add 180 tod 
if ds 0 then add 360 to d 


put trunc(((405+45 - d) mod 360)/90)+1 into posNumber 1 


~- Little fix to avoid rounding errors. 

if posNumber < 1 or posNumber > 4 

then put 1 into posNumber . 
put “"Dial."& item posNumber of iconList into iconName 
set the icon of me to iconName 


-- Additional code to determine what button does re 


if posNumber = "1" then 
-- Put code here for position 1 choice. 
else if posNumber = "2" then 

-- Put code here for position 2 choice. 
else if posNumber = "3" then 

~- Put code here for position 3 sholce. 


Put code here for position 4 choice. 
end if 
end if 
end mousestil }down 
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Figure 4 
A sliding control 
from 101 Scripts & 
Buttons for Hyper- 
Card. The script for 
the icon is found in 
Listing 4, but the 
script for the trans- 
parent button over- 
laying the paint 
graphics is found in 
Listing 5. 


Knobs 


Although toggle buttons are 
great for specifying one of two 
states, they are not terribly good for 
indicating a single option when 
there are multiple possible states. 
Turnable knobs are an excellent 
way to input a single condition from 
several options. This seems particu- 
larly appropriate for variables which 
bear similarities to those controlled 
by knobs in the real world, e.g., vol- 
ume or temperature settings. 

Listing #3 shows a fairly gen- 
eral solution to flipping ICONs for 
the simulation of a turning knob. It 
is quite easy to make minor changes 
to this basic script for knobs with 
different numbers of discrete posi- 
tions or different angular positions. 
There are also many other scripting 
approaches which can be used to 
simulate turning knobs. 

Although knobs allow access 
to more values than toggles, they 
are constrained by the number of 
discrete positions in a circle which 
you can reproduce on a graphical 
screen of limited resolution. The 
practical limit for HyperCard seems 
to be about 16 positions. While you 
can create icons for more than 16 
positions, they are very difficult to 
visually distinguish. Sliding controls 
offer another alternative with many 
more potential settings. 


Sliders 


Sliding controls, or sliders, typ- 
ically move a pointer or indicator 
along a straight-line axis. The most 
familiar sliding control on the Mac is 
the scroll bar—but don’t forget the 
volume control on the Control Panel 
Desk Accessory. With sliding con- 
trols the range of alternatives is only 
limited by the number of pixels on 
the axis (100 in the case of Figure 
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Listing 4 - Script for Slider Icon in Figure 4 4). It is possible to use any arbitrary 
angle, or even curved lines, as the 
axis, but it is much simpler to pro- 
gram using the X or Y axis. Listings 
4 and 5 provide scripts for control- 
ling a vertical sliding controller at a 
specific screen position. The Listing 
4 script could be improved by mak- 
ing it independent of screen 
location. 


Conclusions 

All three of these graphical 
controls (toggles, knobs, and sliders) 
offer richer methods of data input 
than text entry. They share several 
advantages over text entry: 


e Due to their real world counter- 
parts they are equally familiar to 
both experienced and naive com- 
puter users. 

e It is impossible to enter com- 
pletely invalid data, thus eliminat- 
ing the need for data validation. 

e They offer continuous visual feed- 

| back during the process of indi- 

Listing 5- Script for Transparent Button over Scale in Figure 4 cating the user’s choice. 

“] © Because they are mouse-driven, 
they do not require knowledge of 
typing or even the use of a 
keyboard. 


Create Your Own... 


..actors that add life to your HyperCard stacks. Actors are ideal for interactive 
training, advertising, entertainment, and education. HyperAnimator is a powerful 
multimedia presentation tool which extends HyperCard. It represents the next 
generation computer interface. Put it to work (or play) for you today. 


Albert, co-star of Disney’s new 


‘*Absent-Minded Professor,” 
was created in one day using 
HyperAnimator. 


“Extremely intuitive. Great product.” 


— Jay Johnson, StakDek, Inc. B ri 4 h t S t a r 


“Fascinating leading-edge technology.” 
— Roger Wood, HyperLink Magazine 


b Relate Sag eeeen cee TA «ae I ea 


14450 NE 29th Pl., Suite 220 


. Bellevue, WA 98007 (206) 885-5446 
“*Slick!”” — Brian Trusler, Hawaii Today si — 


HyperAnimator is a trademark of Bright Star Technology, Inc. 


j Ferre i ° HyperCard is a trademark of Apple Computer, Inc. 
‘This is just great. I’m so impressed.” “Albert” © 1988 StakDek, Inc. All rights reserved. 


— Yasuhiro Hayashi, Tokyo, Japan 


Available from your favorite software supplier. Comes complete with HyperCard. 


“Securities Grapher” Is a Stack That Makes Practical Use of the Paint Tools 


by William K. Balthrop 


graphic devices. Used under script control they 

can create attractive and utilitarian charts and 
graphs. To demonstrate the techniques involved, we’ve 
devised a “Securities Grapher” stack for this issue’s 
“Short Stack.” This stack presents a simple but effective 
approach to converting a table of data for a stock into a 
“HiLo” chart (see Figure 1), which should be familiar to 
anyone who has ever tracked securities. This stack 
tracks a single security for 116 days, and it automatically 
scales the values that have been input so the highest 
value appears at the top of the chart, the lowest at the 
bottom, with the others correctly scaled in between. 


T he Paint tools in HyperCard are a versatile set of 


Creating the Graph 

To create the screen in Figure 1, ensure that you 
are in scripting level by checking the “Scripting” check 
box on the last card of your “Home” stack. Next, select 
“New Stack...” from the File menu. Name the stack’ 
“Securities Grapher” and be sure that the “Copy Current 
Background” option is not checked. 

Because the “Securities Grapher” paints to specific 
locations on the screen it is critical that the graph is set 
to exactly the correct locations on the screen. The 
“Home” script of the latest version of HyperCard (ver- 
sion 1.2.2) contains an excellent handler called xy that 
can aid in this process. 


on xy 
-- puts the mouse location in the message box 
-- until a mouse click 

set the cursor to cross 

repeat until the mouse is down 

put the mouseLoc 

end repeat 

set the cursor to browse 
end xy 


If you haven’t updated your “Home” stack by put- 
ting the latest scripts into it, be sure to add this one to 
your “Home” stack script before you go any further. 


William “Kelly” Balthrop is the Director of R & D at 
HyperLink and has been developing and publishing com- 
puter software for the last decade. 
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Figure 1 
This is the “Securities Grapher” stack’s only card. This “HiLo” 
chart helps demonstrate some scripting techniques for using the 
Paint tools to translate data into a more easily understood 
form. 


Anytime you want to get an exact screen location, just 
show the Message box, type “xy” into it, and press 
Return. As you move the mouse, the horizontal and ver- 
tical positions of the mouse are displayed until you click 
the mouse again. 

Let’s begin by creating the vertical axis of the 
graph. Tear off the Tools menu and place it near the 
bottom-right corner of the screen. Double click the Line 
tool and select the narrowest line, the one on the far 
left. Select the Line tool from the Tools menu, show the 
Message box, type “xy,” and press Return. Now, without 
clicking, move the mouse toward the upper-left corner 
of the screen until the Message box reads “40,62.” Next, 
draw the vertical axis by holding down the mouse but- 
ton and dragging straight down to a point about two 
thirds of the way down the screen. Again, type “xy” fol- 
lowed by Return into the Message box to check where 
the bottom end of the line is. You want it to be at 
screen location “40,202.” Adjust the line by either 
extending it with the Line tool or erasing it with the Era- 
sure tool until the line goes from precisely “40,62” at the 
top to “40,202” at the bottom. 

Next, using the Line tool again, draw the horizon- 
tal axis from “40,202” to “506,“202.” Now add the hori- 
zontal and vertical tick marks as shown in Figure 1. 
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These marks are 20 pixels apart and sedan 1- Sb for Card Field “Daily Data” 
8 pixels long—i.e., the marks on the [Ap wmaneawithin 
vertical axis are placed at 62, roll of ca ard | field "Day" to ~ 
82,102,122, etc., and the horizontal e scroll of 
axis marks are placed at 40, 60, 80, 
100, 120, 140, and so on. 

The stack’s title, and the day 2 
numbers across the bottom are on mouseUp © : 
painted on using the Text tool (the } Set cursor to busy 


_W repeat with num=1 to 116 
ye es dis: put num into item 1 of line num of cd fld "Day" 


label every 20 days. ene peat to bu sy 


Adding the Fields 


Down the left side of the 
graph there are eight fields that hold 
the range of values of the securities. 
One of the nicest parts of “Securities 
Grapher” is that it automatically 
scales the values and inserts appro- 
priate numbers into these fields. All 
eight fields are identical except for 
their names, which must be “Scale 
1,” “Scale 2,” “Scale 3,”. and so on, 
for the scripts to work properly. The 
bottom field (containing the number 
30 in Figure 1) is named “Scale 1” 
and the top field (containing 43 in 
Figure 1) is named “Scale 8.” 

To create these fields, first 
select “New Field” from the Objects 
menu, then “Field Info...” from the 
Objects Menu, and name the field 
“Scale 1” by entering the name in 


es 
i 


i fis in cd fid "Daily Data” into ead 


pu | of i sete word 4 of iver 
put minMax 
exit mouselp 


the “Field Info...” dialog box.Select end if 

the font by clicking on the “Font” 7 put item 1 of minMax into mn 
button in the box, and set the font . put item 2 of minMax into mx 
to 9 point Geneva. After you click end repeat 


“OK,” move and resize the field so it | Put ; 1 ipesue into NumDay S 
fits in between the bottom tick mark | | 
on the vertical axis and the left edge 
of the HyperCard screen. Now you 
can “clone” the remaining fields by 
holding down the Option key, and 
clicking and dragging up on the first 
field. Each time you create the new 
field, be sure to rename by opening 
its “Field Info...” as we did above. 


The Data Fields bes 
The fields at the bottom left of put item 2 of. theData i tate High 


the screen are where the data is put item 3 of thel ata into. cl ose 
entered for the graph. These two | / Nu 

fields appear to be a rectangular 
field on the left and a scrolling field 
on the right, but actually they are 


both scrolling fields with the field on of F St t. a ~~ toy tate 4 em “9 ~ Start 


the right on top of the lett one, cov- er of ee 201). ‘into item, 2 of Stop 
ering its scroll bar. You create these put max(it : 

by again selecting “New Field,” and drag from Sta Dp 

then “Field Info...” from the Objects it netas + (Cinenum - Db * )). trune(202 . 

menu. Next name the field “Day,” | | - Mn) * adjuster) 1 


40 HyperLink Magazine 


Constantine» 


ee 
a 
oe 
§ SER, 
Romantic Intro 
General Essay _ 


a 


Begin... 


Middle Renaissance (1520-1560) 


Historical Essays 


Henry Vill 
Begin... 


Holbein, 
Henry Vill 


St. Mundus of Argyle's Day ¢.962 


Premiere of Bach's “St. Matthew Passion” in Leipzig in 1729 

Samuel Johnson's "Dictionary" published in 1755 

The $.S. TITANIC went down in 1912 losing 1513 of her 2224 passengers 

Pleny Wingo began his backwards walk of 8000 miles from Santa Monica, Cal. 
to Istanbul, Turkey in 1931 (ended walk 24 Oct. 1932) 


BIRTHS 
LEONARDO DA VINCI - 1452 


Carolingian é 
Historical Essays 

Vikings 

Begin... 


*: 


$s 


Prrrrrrr rrr irri triers 


ip 


3S 
SER 
SS 333 


Prow of a Viking ship >> 


LO--0--04 s Notes 


ssececsceed 


Neveeeneseee 


jee Cultural 
Resources, In 


Creative Software for the Hi 
Educational Institutions and 


ee ee | PS oe a a | 


Listing 3 - Phones for the “Plot feet 8 Button - continued 


| end repeat © : 

choose Bronce tool 
/ unlock screen with Viel dissolve 
| put "Graph complete!" _ a 


| wait 3 seconds 
put empty 
| hide msg 
fend mouseUp — 


function CheckData latestData 
global mn,mx : 


| Fepest, with a to the number sof tea 9 of Tatestdata 


. Cond is “Seppo” then. 


put “Error in day x - fice number" ‘into minwax 


return minMax 
| eno it. 
one repeat 


if the number. o items in latestData # 3 then 
put "Error in day x — wrong number of items!" into 5 


minMax 


else if min(latestData) « item 1 of latestData then 
eo "Error in n day x item i not lowest!" into minMax 


put "Error in. “day x — jten 2 fot Highest!” ‘into minMax 
| else put min(min(latestData), me te 
-max(max(latestData), x) into minMax 


return minMax 
end checkData 


| function CheckNum Num 
- put 0 into decimals 


| repeat with curnum = 1 to length (Num) 


set cursor to busy 
if char curnum of num = 


“a then add 1 to decimals 


if char curnum of num is in "1234567890. "and 
decimals < 2 then next repeat 


else return "Error" 
end repeat 


if Num = ‘empty on Num « 0 then put 0 into num 


| add zero to Num 
| return Num 
end CheckNum — 


on ClearGraph 

Jock Screen 

| choose select £001 S 
drag from 44,201 to 508, 62 
domenu "Cut Picture” | 
choose browse tool. 
unlock screen 

| set the cursor to Waren 

| lock screen 

end Cl eararaph 


and select “Scrolling” under “Style,” 
then press the “Font” button, and 
choose Chicago, 12 point. Now, 
move and resize the field to go in 
the lower-left corner of the screen, 
so it will hold 5 lines of text, and be 
wide enough to easily hold 3 char- 
acters across. Next, clone the left- 
hand field by holding down the 
Option key, then click and drag to 
the right on the “Day” field. Remem- 


42 


ber to leave this new field so it cov- 
ers the scroll bar of the “Day” field. 
Choose “Field Info...” from the 
Objects menu and name this new 
field “Daily Data.” Click “OK” and 
resize this field so it looks like the 
field in Figure 1. 

Now, enter the script in Listing 
1 into the “Daily Data” field’s script. 
This script synchronizes the scrolling 
of these two fields. There are draw- 


backs to this relatively simple 
approach, but as long as you keep 
the mouse cursor within the “Daily 
Data,” the two fields remain 
synchronized. 


Creating the Buttons 
Now we're ready to create the 
three buttons on the card: 


e “Day - Low, High, Close” 
e “Fill Day Field” 
e “Plot Graph” 


The “Day - Low, High, Close” 
button is a rectangular button that 
acts as a label for the “Day” and 
“Daily Data” fields we just 
created. You could just as easily use 
paint text or a field, but creating a 
rectangular button with its “Show 
Name” checked is effective for this 
purpose. 

The “Fill Day Field” button 
simply fills the “Day” field with the 
number 1 through 116, so it will 
allow us to easily identify the data in 
the “Daily Data” field. Once you 
create this button, enter the script 
shown in Listing 2, and click on it 
once, you can delete it. After that is 
a good time to set the lockText of 
the “Day” field to true in its “Field 
Info...” dialog box. 

The real workhorse of this 
stack is the “Plot Graph” button. Just 
choose “New Button” from the 
Objects menu, and then select “But- 
ton Info...” and name the button 
“Plot Graph” in the dialog box. Next 
click the “Script” button and enter 
Listing 3 into the button’s script 
window. 


Using “Securities 
Grapher” 


To use this stack, all you need 
to know is how the data in the 
“Daily Data” field is to be formatted. 
Each line must have 3 numbers sep- 
arated by commas. The first number 
must be the lowest, the middle num- 
ber the highest, and the third num- 
ber must be either in between these 
two or equal to one of them. Each 
line must be ended by pressing 
Return—if you just press the space 
bar until you reach the next line, 
you will get an error when you 
press “Plot Graph.” Have fun, 


and good graphing! 
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The “Letter Learner Stack” 
—continued from page 14 


Perhaps one day a neural network 
will be built that can examine a 
stock and decide which category it 
falls in: “Buy” or “Don’t buy.” 

It should be pointed out that 
conventional artificial intelligence 
has grappled with all of these prob- 
lems, but has generally failed to 
solve them. Neural networks are an 
alternative to conventional AI. 

By the way, the “Letter 
Learner” stack contains a list of cur- 
rent references on neural networks. 


How to Use “Letter 


Learner” 

“Letter Learner” is the first in a 
series of NeuralStacks—stacks that 
demonstrate and teach neural net- 
works. “Letter Learner” can be 
taught to recognize letters of the 
alphabet that you draw using the 
mouse. 

When we begin, it knows 
nothing. It will not recognize any 
letters because you haven’t taught it 
any yet. We can teach “Letter 
Learner” to recognize letters by 
drawing a letter into the box in the 
middle of the screen, and then 
pressing the button corresponding 
to that letter ( see Figure 3) 

Now “Letter Learner” has 
learned the letter T. The letters that 
it learns appear in the column on 
the far left of the screen. If we use 
the same method to teach the letter 
U, the screen appears as shown in 
Figure 4. 

Now that “Letter Learner” 
knows some letters, let’s test its 
knowledge. We can draw any one 
of the letters it knows, and press the 
“GUESS” button in the lower right- 
hand corner. “Letter Learner” 
guesses T correctly (see Figure 5). 

The numbers at the far left can 
range from —5 to +5, and they repre- 
sent the amount of “U-ness” and “T- 
ness” of the letter you just drew. The 
letter with the highest value is the 
letter it guesses. “Letter Learner” can 
learn up to 13 letters at a time. 

Now that we’ve seen how to 
use “Letter Learner”, let’s examine 
how “Letter Learner” works. 
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Figure 6 


How “Letter Learner” 
Works 


When a letter is drawn into 
“Letter Learner”, as in Figure 6, “Let- 
ter Learner” views it atop a 5 by 5 
grid (see Figure 7). 

For each square in the grid, 
“Letter Learner” determines whether 
or not anything has been drawn in 
that rectangle (see Figure 8). 

If something has been drawn 
in that rectangle, the rectangle is 
assigned a value of +1. If nothing 
has been drawn in the rectangle, 
that rectangle is assigned a value of 
—1 as shown in Figure 9. 

This series of numbers is then 
read left-to-right, top-to-bottom, 
creating what is called the “input 
vector.” When you press the “J” but- 
ton, a single neurode is allocated to 
represent the letter, and the input 
vector is fed as input to that 
neurode. 

The J neurode “remembers” 
that series of numbers in a form 
called the “weight vector,” and 
when guessing a letter, it compares 
the input vector for the letter you’ve 
drawn to its weight vector. If you 
teach more than one J to “Letter 
Learner”, rather than allocate two 
neurodes for that letter, “Letter 
Learner” simply modifies the weight 
vector for the J neurode to reflect all 
the J’s it has learned. This is 
explained in detail in the Help sec- 
tion of the “Letter Learner” stack. 

There are many different types 
of neural networks, and all of them 
use variations of the concepts we’ve 
just discussed. Most neural net- 
works, however, don’t use a strategy 
of one neurode per concept. Most 
neural networks connect the neu- 
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Figure 7 


rodes together in one pattern or 
another, and it’s the combination of 
neurodes that fire that determine 
which concept is being represented. 
The method that “Letter Learner” 
uses, that of one letter per neurode, 
is a variation on MADALINE, 
invented in 1960 by Bernard 
Widrow at Stanford University. 


“Letter Learner” and 
HyperCard 


“Letter Learner” is a HyperCard 
stack, and its safe to say that without 
HyperCard, I'd still be just starting 
the project. After using HyperCard, I 
can’t conceive of ever using a more 
traditional programming language 
for a complete project again. None- 
theless, writing “Letter Learner” was 
a far from trivial task. At least one 
function that my program needed to 
perform could not be done with 
straight HyperTalk commands, and 
five of the mathematical functions 
that I needed to process the input 
vector and the weight vectors were 
simply too slow in HyperTalk, so I 
turned to Turbo Pascal. 

As you may know, HyperTalk 
allows us to write procedures and 
functions in other languages, such as 
Pascal or C, and call these proce- 
dures from a HyperTalk script. 
These procedures and functions are 
called XCMD’s and XFCN’s, respec- 
tively.To take care of the problems I 
was having with HyperTalk, I wrote 
six XCMD’s and XFCN’s in Turbo 
Pascal. We'll discuss these XCMD’s 
in a moment, but first, let’s examine 
how the concepts of neurodes, input 
vectors, and weight vectors have 
been implemented in “Letter 
Learner.” 


Figure 8 


Mapping Neural 
Network Concepts to 


HyperCard 

In the MADALINE, there are 
only four neural network objects 
that must be represented in Hyper- 
Card. These are: 


e The input vector 

e The weight vector for each 
neurode 

e The output value for each 
neurode 

e The delta vector, which is sort of a 
scaled-down version of the input 
vector 


Mapping these into HyperCard 
is not very difficult. The input vector 
is a series of 25 numbers that repre- 
sent the letter that the user has 
drawn in the box. This has been 
implemented in “Letter Learner” with 
a single field, appropriately called 
“InputVector.” The 25 numbers in 
the input vector are represented by 
25 items in the field. The output 
value for each neurode is a single 
number that represents a compari- 
son between the input vector and a 
neurode’s weight vector, and these 
are stored in a field called “output” 
that appears on the far left of the 
screen. 

Representing the weight vector 
for each neurode is only slightly 
more complex. As previously dis- 
cussed, for every neurode there is a 
weight vector, a series of 25 num- 
bers, that represent that neurode’s 
memory of the letter that it is 
responsible for. Rather than have a 
separate field for each neurode, “Let- 
ter Learner” uses a single field that 
holds the weight vectors for all the 
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Figure 10 


In the field “WEIGHTS” after having learned the letters B, T, and U. Since B, 


the 2nd, 20th, and 21st letters of the alphabet, only those lines of the field have values 
in them. The weight vectors for B and U are too long to fit on the screen. 


neurodes. Since there are only 26 
letters of the alphabet, and since 
“Letter Learner” only allocates one 
neurode per letter, we need at most 


26 different weight vectors. The field 


“Weights” holds all the weight vec- 
tors for all the letters that have been 
learned. The weight vector for the A 
neurode is stored in line 1 of this 
field; the weight vector for the E 
neurode is stored in line 5 of this 
field, etc. Again, each line consists 
of the 25 numbers in that vector, 
separated by commas. This allows 
us to refer to the 7th element of the 
weight vector for the E neurode as 


item 7 of line 5 of field = 
"Weights" 


The field “Weights” is shown 
in Figure 10, and it represents the 
state of the network after having 
learned the letters B, T, and U. 

It should be pointed out that 
“Weights” is a hidden field, and in 
addition, it has been set to a 1 pixel 
by 1 pixel rectangle. Thus, inside 
“Letter Learner,” there is no way to 
examine this field directly. Instead, 
“Letter Learner” allows you to exam- 
ine a single line of the field by turn- 
ing on a switch called “Show Vec- 
tors.” When this switch is on, the 
weight vector for the letter you’ve 
just taught “Letter Learner” appears 
in a field on the bottom of the 
screen. In addition, “Letter Learner” 
provides a 5 by 5 grid that allows 
you to examine a graphical repre- 
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T, and U, 


A single button covers this section of the 
screen. A somewhat complicated formula 
is used to figure out what section of the 
button the user pressed, and hence, what 
letter is underneath that section. 


Listing 1 


sentation of the weight vector for 
any neurode you like (see the stack 
itself for more details). 


Processing Neurodes in 


“Letter Learner” 


Now that we know how “Let- 
ter Learner” works, we can examine 
a scripting technique in “Letter 
Learner” that does the work of allo- 
cating neurodes and adjusting the 
neurodes’ weight vectors. The bulk 
of the work here is done by the 
script that goes with the single but- 
ton that covers the entire list of let- 
ters (see Figure 11). 

After doing some math that 
determines which letter the cursor is 
on top of when the user presses the 
mouse button, the partial script in 
Listing 1 is executed on mouseUp. 

In English, this says that if the 
letter in question has not already 
been learned, allocate a neurode for 


that letter and then process the neu- 
rode (i.e., do all the necessary math 
for that neurode); otherwise, process 
the neurode that has already been 
allocated. In addition, the number of 
letters already taught is kept in a 
field called “numNeurodes.” This is 
compared with the maximum num- 
ber of letters that the network is 
allowed to learn at once (in this ver- 
sion, that number is 13). Notice that 
the letter being taught is stored as a 
number, not a character; thus, the 
letter E is stored in the container 
“LetterNum” as the value “5.” 

How can we tell if a letter has 
already been taught? Simple: If the 
letter has not yet been taught, the 
line that corresponds to that letter in 
the field “Weights” will be empty; 
otherwise it will have numbers in it. 
So the function allocated, which 
determines whether a particular let- 
ter has been learned by the net- 
work, reads as shown in Listing 2. 
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When we allocate a new neurode, 
all we have to do is initialize that 
neurode’s weight vector to all zeros. 
The allocateNeurode handler does 
just that (see Listing 3). 

ZeroList is a global variable 
that contains a string of 25 zeros, 
separated by commas. The field 
“LetterList” is the list of the letters 
that have already been learned that 
appears on the far left of the screen. 

All of the necessary math is 
done by the processNeurode han- 
dler shown in Listing 4. The 
DeltaVector and AdjustWeights 
XFCN’s (see box within Listing 4) 
deal with vector arithmetic. The 
DeltaVector handler takes the 
input vector and shrinks it; 
AdjustWeights takes the shrunken 
input vector and adds it to the 
weight vector for the neurode in 
question. This process is repeated 
twice, in order to give the weight 
vector a bit more strength. 

The XFCN’s DeltaVector and 
AdjustWeights do simple vector 
mathematics. These were originally 
implemented in HyperTalk, but 
HyperTalk took too long to do the 
math, so they were converted to 
Turbo Pascal XFCN’s instead. 


DrawAndGetInputVector 


XCMD 

The biggest difficulty that I had 
in writing “Letter Learner” was in 
allowing the user to draw a letter on 
the screen. The first method I tried 
involved creating a rectangular but- 
ton on the screen for the letter to be 
drawn in, and simply attaching the 
following script to the button: 


on mouseDown 
choose paint tool 
end mouseDown 


There are actually several 
problems with this solution, but the 
biggest one is that once the paint 
tool is chosen, the letter drawn can 
extend out of the button that 
received the mouseDown message 
(see Figure 12). HyperTalk provides 
no way to restrict the users drawing 
within particular screen limits. 

I solved the problem by writ- 
ing an XCMD which I titled 
DrawAndGetInputVector Gf you’re 
not a programmer, you may not fol- 
low the rest of this discussion, but 
don’t worry—understanding this is 
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Listing 2 


Listing 4 


not necessary to be able to use “Let- 
ter Learner”). This XCMD takes the 
top-left and bottom-right corners of 
the letter button as parameters, and 
declares a rectangle at the same 
location as the button. Then the 
Macintosh Toolbox QuickDraw pro- 
cedures are called to allow the user 
to draw only on the screen when 
the mouse is both down and within 
the rectangle. As the user draws the 
line, the information needed to 
derive the input vector is collected, 
and it is passed back to the “input- 
Vector” field in the stack. 

The five other XCMD’s and 
XFCN’s in “Letter Learner” are used 
to do the mathematics behind neural 
networks quickly and easily. 
Because the concepts involved in 
understanding neural networks are 
so complex, and because most peo- 
ple do not have intuitive knowledge 
of vector arithmetic, these more 


Here’s what would happen if we used the 
"choose paint tool" message to let the user 
draw their letter in the box. 


technical aspects of neural networks 
are beyond the scope of this article. 
HyperCard is a good environment 
for neural networks because it 
allows the concepts to be explained 
and demonstrated in a more intui- 
tive and non-linear fashion. If your 
curiosity was piqued by this article, I 
hope you will obtain a copy of “Let- 
ter Learner” and send me any com- 
ments you have about it. 
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What Is a Musical Palindrome? 
What Medieval Scourge Killed Petrarch’s Sweetheart, Laura? 
Find Out in... 


Culture 1.0 


alter Reinhold is a teacher—an extraordinary 
. ‘ / teacher. Now, his classroom can meet world- 

wide, yet each student can individually bene- 
fit from his careful tutelage and scholarship by opening 
a folder on a Macintosh desktop. This folder is named 
Culture 1.0, the first HyperCard software efforts of Cul- 
tural Resources, Inc., (CRI) of Scotch Plains, New Jersey. 
And, what an effort it is! 

A lecturer in the Bible and theology, as well as 
many other subjects, Professor Reinhold is also an organ 
recitalist with numerous performances to his credit. His 
educational expertise is primarily in music history and 
style analysis, giving him a remarkably rich historical 
platform from which he has designed sixteen courses 
covering medieval to 20th century music, art, and his- 
tory. He has taught thousands of students on the under- 
graduate, graduate, and professional levels since 1968 at 
New York University, and currently also teaches at the 
School of Music at Kean College of New Jersey. 

In Culture 1.0, Professor Reinhold conveys his 
philosophical style of teaching about knowledge and 
perspective. He believes that one’s perspective is the 
basis of wisdom. If one is truly to be called educated, 
knowing how cultural and historical facts are woven 
throughout the tapestry of civilization is integral to that 
education. To this end he has dedicated his exceptional 
talent to the world of scholarship. He does not fail us. 


How to Begin? 

First be certain your system meets the essentials. 
Culture 1.0 requires HyperCard 1.2 (or later) and a hard 
disk with 5 Megabytes (MB) of free space. The user’s 
manual is simple. It carefully coaches even a novice in 
loading the nearly 5 MB of information (seven disks). 
Due to the intelligent graphic screen design and easy-to- 
follow manual, one can start gaining perspective by 
browsing history within minutes of creating the folder. 

Install Culture 1.0 following the directions pre- 
cisely. When all 10 stacks are displayed, begin by dou- 
ble clicking on the “Overview” stack. From the overview 
screen (see Figure 1), one can navigate all the compo- 
nents of Culture 1.0. Reading the overview notes and 
then displaying the roster of essays provides the 
browser with the essence of the program. 

People, events, dates and facts—the chrysalis of 
western civilization—come alive, and Walter paints a 
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Figure 1 
This “Overview Card” is the takeoff point for Culture 1.0. It is 
virtually always a single mouse click away, so the user can 
return to it to launch a new exploration of a different time, 
place, or subject matter. 


contextual canvas with a masterful touch of organiza- 
tion. The specific eras and generations form the chrono- 
logical timeline, and these are further delineated by 
country and discipline. The framework of Culture helps 
you to experience the most important composers, paint- 
ers, architects, authors, leaders, and rulers in each era. 
You also see many great works of art and architecture 
(there are over two hundred graphic images in Culture). 
Plus, you can listen to 75 signature melodies of the com- 
posers. One drawback to the music, however, is the 
sound quality. Due to space limitations (yes even 5MB is 
not enough), the sounds were sampled at a relatively 
low sample rate (11KHz), and the quality is not as pure 
as it could be. For you audiophiles out there, the sam- 
ples contain some aliasing. 
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Professor Reinhold has retained an enormously 
enthusiastic and gifted talent for teaching. One that 
translates well to the Macintosh. This talent reaches right 
out through the Mac screen and keeps one clearly 
focused on learning. His ebullient personality truly radi- 
ates through the introductory essays, the 30 general 
essays that introduce each historical period with specific 
references to music and art; plus, 59 period essays on 
people, events, and interrelated aspects of history. He 
writes concisely, with a wit and energy that we may all 
be uniquely touched by. The time periods of study are 
the Middle Ages, Renaissance, Baroque, Classic, Roman- 
tic, and 20th Century. Each era also has a “popmenu” 
listing the sub-periods available for study. Additionally, 
three supplemental resources—Biblical History, Greco- 
Roman, and a Cultural Almanac can also be accessed for 
even more in-depth information. 

Perhaps 20 years of devoted scholarship and a 
lively, intelligent and humorous viewpoint keep this 
compendium of historical facts, grids, and cultural time- 
lines vibrant among the many cultural disciplines Profes- 
sor Reinhold enthusiastically shares with us. We, as 
eager “magnetic media” students, transcend time from 
the Ancient Greeks up until the 20th Century. It is a joy. 


Customization Features 


Culture 1.0 incorporates three very important fea- 
tures that let you make its stacks your own personal 
reference: : 


e First, its “Culture Links” button allows you to create/ 
delete customized links to other relevant cards of your 
own choosing. 

e Second, its “Smart Paths” structuring capability allows 
custom navigational path or custom lists of an associa- 
tive network of cards (bridging all 10 stacks in Cul- 
ture) to be generated. If one were researching a spe- 
cific topic over several disciplines, the “Smart Path” 
option would be invaluable. Culture’s programmers 
have made it easy for you to follow the four steps 
required to load, save or clear a specific path. 

e A third major feature is the “Reader’s Notes” button 
allowing individual thoughts or comment additions to 
any card at any time. With the normal HyperCard 
30,000 character per field limitation, that should be 
sufficient for anyone’s needs. User/reader notes can 
be saved as a text file for importing into a word pro- 
cessor for printing. This “Do Reports” function is ver- 
satile enough to save notes for a single card, or all of 
your notes for an entire time period. 


“Knowledge Navigation” Pioneers 

With HyperCard’s inherent linking facility, CRI’s 
programmers have structured over 2,000 word links 
allowing generous free-play of the mind. Talented pro- 
grammer Thomas Tafuto of Applied Imagination showed 
some incredible skill in software design building this 
product. Employing the HyPict XCMD, written by Mar- 
tine Heinsdorf, much of the art can be proportionally 
and automatically re-sized into an expandable, floating 
window—the larger the window, the larger the art. (see 
Figures 3, 4, and 5) 
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Mature Renaissance (1520-1500) 


CULTURAL GRID 


o> ENGLAND [x] 


> FRANGE [x] 


> GER/NETH/SPN [X] 


‘wy TTALY [x] 


Figure 2 
The Cultural Grid makes it easy for the Culture 1.0 user to 
explore a period of history both by country and by discipline. 
Comparisons and contrasts are easy to make between both 
diverse and closely related times and places. 


Hellenic Culture 


ARCHITECTURE H 
Orders of Columns 1 


Doric Order lonic Order (2C)== Corinthian Order 
£6 ‘< = T ad) pet 


Here three HyPict windows are displayed allowing the user to 
compare three Hellenic Orders of Columns. 


Another nifty feature is Cu/ture’s quick scan capa- 
bility. Need to quickly scan all cards in a specific stack? 
Just use the left or right arrow button at the corner of 
each card and you can navigate easily. Exit by clicking 
the mouse button. 

Recommending this here-and-now educational 
workstation for gaining perspective on what has shaped 
western culture is a pleasure. This is a college extension 
course for a very minimal price. Curiosity is the only 
prerequisite. Every student and educator should have 
access to this involving database of the humanities. 

Thanks to Walter Reinhold, Chris Chapman (the 
student that discovered him and combined his knowl- 
edge and HyperCard), and the devoted team at CRI and 
Applied Imagination for their considerable effort to 
bring this product to market at a time when software of 
this calibre is essentially nonexistent. They win all 
awards I could possible give. Return to this program 
when negative stress starts to encroach on your personal 
creativity. An hour spent with Culture 1.0 will refresh 
and inspire you to put those nagging business concerns 


HyperLink Magazine 


r 
KR © fT 1} 
IN Lead 


es General Essay 


NATURE AND LANDSCAPES 
& man's environment 
Fra Angelico ¢.1400-1455 was the first to explore this new area 
Sandro Botticelli c.1444-1510 was probably the best “plant man” 


Botticelli, Birth of Venus th 


Figure 5 
Here the same Botticelli as shown in Figure 4 is displayed on 
the smaller Macintosh screen. The HyPict XCMD works equally 
well on all Macintosh screens. 


Cultural Almanac 


Figure 6 
Each section of Culture 1.0 is introduced with scans of signifi- 
cant historical interest. 
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Figure 4 
The HyPict XCMD opens up the possibility of a 
much larger screen display to HyperCard. The 
screen shot here is scaled to exactly the same per- 
centage as the others in this review, but because 
it came from a Macintosh II, it is much larger. 
Notice that two different paintngs are displayed, 
each in its own expandable floating window. 
The artwork is limited to the normal 72 dots per 
inch (dpi) of all HyperCard artwork. CRI plans to 
make use of Apple’s HyperTV as it becomes avail- 
able, which will allow for better resolution, color, 
and even laser disc quality. 


aside so that you may get on with the 
creative pursuits in your life. Yes, Culture 
will relax and inspire you to know more, 
to appreciate more, and serve as a healthy 
reminder to never give up—whatever 
mundane state you may be in at present— 
that aggressive search for learning. Know- 
ing that your search will soon bring you to 
a more appreciative viewpoint of life. 

When you shut down the Mac for the night, I’m 
quite sure it purrs more contentedly with Culture 1.0 in 
a folder happily nested with your more statistically 
oriented software. Yes, culture has come to the desktop. 
It is about time. Walter, your worldwide classroom 
awaits! 


Culture 2.0 Anyone? 


The Mac community is indeed fortunate to be 
among the first to benefit from CRI’s initial software 
developments. With this product as their hub, they plan 
expansion to a Culture 2.0 version on CD-ROM that 
will give listeners improved sound quality. The Interact- 
ing Muse—a series of six CD-ROM disks that feature the 
artists, sculptors, architects, musicians, and other histori- 
cal figures from the six time periods talked about in this 
overview. The Music Tours—a HyperCard blueprint of 
musical architecture from these same six eras. And, last 
but not least, a planned newsletter for cultural informa- 
tion sharing—hoping to attract authors of complemen- 
tary stacks and scripts. 

As we go to press, CRI announced future develop- 
ments for Culture. These will include additional structu- 
ral levels (new types of knowledge, non-Western cul- 
tures, greater level of detail within the cultural database; 
a powerful authoring system for those who do not 
understand HyperTalk; and, color graphics and orches- 
tral sounds. According to company chairman, Chris 
Chapman, “The company is pursuing the utilization of 
HyperTV videodisk technology in order to present Wal- 
ter Reinhold as an animated interactive guide to the pro- 
gram.” [For those of you who haven't heard of this 
future development previewed by Apple’s John Sculley 
at MacWorld Expo in San Francisco, HyperTV incorpo- 
rates the AST video digitizer board to produce real-time 
video images from video tape, laser disc, or live, within 
a window right on the HyperCard screen.—Ed.] 

—Carole Eversole 
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JNTRODUCING 


H YPER 


for the ProViz 
Video Digitizer. 


The first Real-Time 


video software 


designed exclusively 


for HyperCard. 


Video to HyperCard... 


Now you can capture virtually any video 
image directly into your HyperCard stack, 
without the need for still models or a 
freeze-frame. With just one click of the 
mouse you'll instantly grab images from 
camcorders, VCRs, laser disk players— 
even television. 


Hyper Vision is the new software interface 
to HyperCard for the line of ProViz Video 
Digitizers. Because HyperVision was 
developed specifically for the ProViz 
Digitizer and incorporates Apple's Hyper- 
Scan™ software, you can capture and 
display images with unparalleled clarity. 


Real images bring product 
information into focus. 


ZISION | 


Real-time and more... 


M Real-time image capture for frame- 
grabbing or live pictures. 


Image scaling and cropping. 


The dithering algorithms from Apple's 
HyperScan software. 


The extra features of the ProViz soft- 
ware, including image capture in 16 
shades of gray and 256 shades of gray. 


Real-time images bring personnel stacks to life. 


Just imagine what you can do with real- 
world images in your stacks: 


Add frames to the HyperCard front- 
end of an interactive videodisc. 


Supply your customers with an elec- 
tronic sales catalog. 


Add product shots to your on-line 
documentation and demo disks. 


Incorporate photos into your elec- 
tronic mail, personnel, or security 
system. 


Real-world 


power of 
HyperCard. 


..on the entire Macintosh family. 


All you need to run HyperVision and the 
ProViz is: 


M@ Any Macintosh—a Plus, SE, SE/30, 
Il, Ilx, or Iex—with 2 Mb of RAM 
and a hard disk. 


M@ System version 6.0 or later 
M@ HyperCard version 1.2 or later. 


Free 

Demo 

D S i Our self-running 
demo disk will 


show you the simplicity and power 
of Hyper Vision. Call our toll-free 
number today and see for yourself 


why we Say: 

With HyperVision, — 
HyperCard OU: 
never We 
looked so good. 


1-800- 
432-2292 


(in Massachusetts 617°938+7711) 


Pixelogic 


The Vision of the Future i 
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images increase 
the educational 
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© 1989 Pixelogic, Inc. All pictures in this ad are real ProViz images. HyperVision and ProViz are trademarks of Pixelogic, Inc. 
HyperCard, HyperScan and Macintosh are trademarks or registered trademarks of Apple Computer, Inc. 


Scanning Is a Snap with Your Video Camera, 


Proviz & HyperScan 


By David G. Brader 


scanner provides, check out Pixelogic’s ProViz line 

of video digitizers. They offer both grayscale and 
color video digitizer systems. The ProViz Video Digitiz- 
ers can scan anything a flatbed scanner can and more. 
We are just starting to use our units, and I want to share 
some of our excitement with you—including our neat 
“Capture” button that captures images for any stack 
using Pixelogic’s HyperVision stackware. 

When the ProViz hardware arrived it certainly was 
tempting to start playing with the color digitizer immedi- 
ately (with the Mac ID, but I have held off until we have 
the time to thoroughly check out the system with Silicon 
Beach’s new SuperCard. Besides, the ProViz HyperVi- 
sion stack looked interesting. 

HyperVision is a modified and enhanced version of 
Bill Atkinson’s HyperScan (licensed from Apple Com- 
puter by Pixelogic) [See David Brader’s article “Hyper- 
Card and the Apple Scanner” in the Nov/Dec 1988 issue 
of HyperLink for details on using HyperScan with the 
Apple Scanner—Ed.] The Apple Scanner driver software 
has been removed and the ProViz Digitizer driver soft- 
ware added. Pixelogic also modified the look and feel to 
be more appropriate to the ProViz Video Digitizers. 

All the high-tech toys—video cameras, VCR’s, 
video disk plays, and TV’s—can provide images for 
HyperCard stacks when you use a ProViz Digitizer and 
HyperVision. Imagine watching a video on your VCR 
and, at the exact moment you see a scene appear on the 
TV monitor, pressing a HyperCard “Snap” button that 
captures that frame of video. A couple of mouse clicks 
and minutes later that image appears in your HyperCard 
stack, and you are ready for the next take. 


| f you need more scanning flexibility than a flat-bed 


What You Need to Make It a Snap 

You should have at least a Mac Plus with a hard 
drive and HyperCard 1.2 or later to work with the Pro- 
Viz Digitizer and HyperVision. Of course, a video source 
is required, such as a VCR with an NTSC video output. 
My setup for this article was a Mac Plus with 4 mega- 


David G. Brader, HyperLink Magazine’s Publisher, has 
worked with computers for over two decades. 
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A Self Portrait of 
The ProViz Grayscale Video Digitizer 


bytes of RAM, a hard drive, the Proviz Video Digitizer 
(see the self portrait above), a TV monitor with a video 
input jack, and an 8mm Sony video camera/VCR. These 
hand-held units are great for real estate brokers and oth- 
ers that require video capture for HyperCard stacks. 


A Universal Picture-Capture Button 

The “Capture” button I’m presenting here does two 
things. First, it defines, by its size and position, where 
the graphic will be placed on a card. Second, once acti- 
vated it clears its space on the card, opens the HyperVi- 
sion stack, and passes its position and dimensions to 
HyperVision. This button becomes the target for the 
save image function from HyperVision. This means that 
any image captured ends up over the “Capture” button 
on the original card. 

The “Capture” button can be cloned, moved to any 
stack, pasted in a background or card level, and resized 
freely. If multiple “Capture” buttons are placed on one 
background or card, only the single button activated 
receives the video image. Let your imagination run free 
and see what video capture applications you dream up. 

To allow the “Capture” button to function, Hyper- 
Vision must be modified. The modifications do not 
change how HyperVision works by itself. This is 
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because, when HyperVision receives an openStack 
message, if my special global variable, where, is empty, 
HyperVision functions just like the Pixelogic manual says 
it should. 


Button Down Logic 

When you activate the “Capture” button from your 
stack, it opens the HyperVision stack. The openStack 
script in the modified HyperVision stack detects that it 
was entered via a “Capture” button (because the global 
variable where contains here instead of being empty ). 
This modified stack script prepares the “Copy Stand” 
card (see Figure 2) or the “Video Scan” card (see Figure 
7) to show a special “Save Area” button over each of the 
cards’ normal “Scan Area” buttons. The normal “Scan 
Area” button is always proportional to a full HyperCard 
window. The newly visible “Save Area” buttons are pro- 
portional to the “Capture” button that was activated. The 
“Save Area” button is scaled the same way as its com- 
panion “Scan Area” button. 


A “Save Area” button is always located in the 
upper-left corner of its companion “Scan Area” button. 
You resize (or position) both buttons simultaneously by 
dragging the corners (or middle) of the larger “Scan 
Area” button. (An operational note: When in the “Cap- 
ture” button mode, do not use the “Scale Setting” field 
to adjust the scale because the scale relationship 
between the “Save Area” and “Scan Area” buttons will 
be lost.) 

The portion of the previewed image that appears 
within the smaller “Save Area” button rectangle is the 
portion of the image that will be moved back to the 
stack containing the active “Capture” button. 


Figure 1 

A “Capture” button fills the frame of this Photo Album card. 

Figure 1 shows a typical card with a “Capture” but- 
ton sized and positioned to fill the inside of the picture 
frame graphic. In this “Photo Album” stack example, the 
graphic picture frame, “Capture” button, and picture title 
field are all placed in the background. By using the 
“New Card” command from the “Edit” menu blank 
photo album cards can be added. Clicking on the area 


inside of the picture frame on one of these cards acti- 
vates the transparent “Capture” button. 
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Figure 2 
The “Scan Area” is covered by a smaller “Save Area” button in 
the upper-left corner. 
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Figure 4 


This image, caputured on the “Halftone” card, is ready to save. 


Figure 2 shows the HyperVision stack “Copy 
Stand” card with its “Scan Area” button rectangle over- 
laid with the smaller “Save Area” button rectangle. Fig- 
ure 3 shows the same card after resizing and positioning 
the buttons to capture the portion of the image desired. 
The “Preview” button is activated as many times as 
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manual (see Figure 4). Finally, press “Save” on the “Half- 
tone” card, and the HyperVision stack compacts itself, 
copying the proper image area. You are then returned 
to the stack and card containing the activated “Capture” 
button where the image is pasted and positioned over 
the “Capture” button on the card level (see Figure 5). 
Now you could go to a different album page and paste 
another image or activate the “Capture” button from the 
same card and replace the image just pasted. 


Creating the “Capture” Button 

The description of the “Capture” button is listed 
below. Remember, once you have built one of these 
“Capture” buttons, it can be copied and pasted in any 
stack at either the card level or the background level. 
After you have positioned and sized it with the Button 


| Figure 5 ; i tool, choose the Browse tool and the new copy of the 
The image has been pasted over the top of the “Capture” button. button is “locked, loaded, and ready to rock and roll.” 


Background Button: or Card Button: 
Capture 
From Background:----------- 
or From Card:----------- 
AutoHilite: false 
ShowName: false 
Visible: true 
Icon: none 
Rectangle: position & size for your picture 
Style: transparent 
TextAlign: center 
TextFont: Chicago 
LineHeight: 16 
TextSize: 12 
TextStyle: plain 
Button Script: Yes - See Listing 1 


Figure 6 ae 
This card allows you to configure your video capture system. Listing 1 


Figure 7 


The “Video Scan” card is used for live video frame capture. 


required to adjust the ProViz settings and video camera 
position. When you are satisfied with the settings, acti- 
vate the “Scan” button to capture a frame of video. After 
about a minute of processing, the “Halftone” card 
appears with the captured image ready for any adjust- 
ments or enhancements as explained in the HyperVision 
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HyperVision Modifications 

First, open the HyperVision stack and go to the 
“Copy Stand” card. Select the Button tool from the Tools 
menu. Double-click on the rectangle outlined in the 
white scan area. Make sure this is the “Scan Area” but- 
ton by checking the name in the “Button Info...” dialog 
box. Close the box and, while the button is still 
selected, choose the “Copy Button” command from the 
Edit menu. Now, Choose the “Paste Button” command 
from the Edit menu. Double-click on the button again to 
bring up the “Button Info...” dialog box of the copied 
button. Change the name to “Save Area” and replace the 
script in its script window with the following: 


on mouseDown 
send mouseDown to bg btn "Scan Area” 
end mouseDown 


Repeat this whole procedure to the scan area on the 
“Video Scan” card in the HyperVision stack. 
Listing 2 shows the additions to the HyperVision 


Listing 2 - Modifications for the stack script 


on openStack 
global brightness,contrast,oldBrightness 
global oldContrast,walkThrough,— 


global where,xStart,yStart,xSize,ySize 
if where is not empty then 
put xSize div 3 into width 
put ySize div 3 into height 
show bkgnd button "Save Area" — 
Of Card Copy Stand” 
get rect of bkgnd button "Scan Area” 
of card “Copy Stanc” 
put 32 into item i oF 11 
put 2/7 into item 2 of (¢ 
Dut 32 + width Into (lem & OF it 
put 27 + height into item 4 of it 
set rect of bkgnd button “Save Area” 
Of card “Copy Stand” to it 
set rect of bkgnd button "Save Area” 
of card “Video Scan to 1- 
but “32,2/7,203,141" tate ic 
set rect of bkgnd button "Scan Area” 
Of card “Copy Stand to it 
set rect of bkgnd button “Scan Area" 
Of card “Video Scan to it 
scale 100 
end if 
set cursor to watch 
~-Leave the rest of this script 4s 1s 
end openStack 


on closeStack 
global Install,settings,ProViztype,-— 
Camera,AddressLoc ener] 
Tf instal) 13 “on en exit closestack 
put empty into where 
hide bg btn "Save Area” of card -— 

‘1 Copy Stand” 
hide bg btn "Save Area" of card - 
"Video Scan" 
show menuBar 
get ProViz(KillBuffer) 
get HyperScan("CloseScanner™) 
writesettings 
compactstack 

end closeStack 
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stack script; the changes are in the boxed area. Replace 
the script in the “Scan Area” button on the “Copy Stand” 
and ”Video Scan” cards with the script in Listing 3 ,then 
go to the “Halftone” card and replace the existing “Save” 
button’s script with the script in Listing 4. na 
2 


Listing 3 - Script for the “Scan Area” buttons 


on mouseDown 
global where, xSize, ySize 
hide me 
if where is not empty then 
hide bg btn “Save Area” 
get the rect of me 
put item 3 of it-item 1 of Tt into otdx 
put item 4 of it-ttem Zz of Tt into oldy 
put "32,2/7,201,¢c08. (to pinkect 
get HyperScan("“DragRect”,— 
rect of me,pinRect) 
set the rect of me to it 
put item 1 of it into item 1 of newRect 
put item 2 of it into item 2 of newRect 
but xSize * (item 3 OF 10 - 
item 1 of it) div 512 into newX 
put newX + item 1 of newRect into -— 
item 3 of newRect 
nut ySize * (item 4 of it - = 
item 2 of it) div 342 into newy 
put newY + item 2 of newRect into — 
item 4 of newRect 
set rect of bkgnd Button "Save Area" — 
to newRect 
show bg btn "Save Area” 
else 
put "3c,27,201,161" tnto pinkect 
get HyperScan("DragRect",-— 
rect of me,pinRect) 
set the rect of me to it 
end if 
show me 
scalegauge 
end mouseDown 


Be 
eS 


Nf 


Listing 4 - Script for the “Save” button 
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on mouseDown 
end mouseDown 


on mouseUp 

global where,xStart,yStart,xSize,ySize 

if where is not empty then 
put empty into where 
domenu compact stack 
choose select tool 
drag from 0,0 to xSize,YSize — 
with optionKey 
doMenu "Copy Picture™ 
pop card 
choose select tool 
doMenu “Paste Picture” 
drag from 0,0 to xStart .ystart 
choose browse tool 
hide menuBar 

else 
set hilite of me to true 
set cursor to busy 
saveCard 
set hilite of me to false 

end if 

end mouseUp 


A Look at Two Commercial Products That Expand HyperCard’s Horizons 


by James Paul 


n the last two “Xpanding HyperCard” columns, we 
| explored the HyperCard Toolbox and how it 

works. Now that we are better acquainted with the 
way XCMD’s and XFCN’s work, let’s take a look at 
what’s going on in the commercial marketplace. We'll 
look at how VersaCad is using HyperCard to enhance 
Computer Aided Design, and how Symmetry has given a 
piece of HyperCard to regular applications. 


HyperCad 

VersaCad Corporation has added an interesting 
and powerful ability to VersaCad/Macintosh Edition. 
Using XFCN’s, VersaCad provides the ability to read 
drawing information into a HyperCard stack, process 
and modify it, and save it back to disk. VersaCad comes 
with stacks that can use drawing information to calcu- 


Through the use of the HyperCad 
XFCN’s, HyperCard becomes a 
powerful extension to VersaCad. 


late, for example, bills of materials (see Figure 1), or 
door and window schedules. In fact, there is a “Paramet- 
ric Design” stack that can allow VersaCad drawings to 
be displayed and altered from within HyperCard, with 
changes saved back to the VersaCad file. Through the 
use of the HyperCad XFCN’s, HyperCard becomes a 
powerful extension to VersaCad. 

Out of the box, the HyperCad stacks are signifi- 
cantly powerful. Also, they can be “tweaked” for specific 
projects fairly easily, since they are regular stacks. What 
makes HyperCad shine, however, is that new stacks can 
be written and completely customized for nearly any 
type of CAD work. Details about how the XFCN’s work 


James Paul is chief programmer for Paul Software Engi- 
neering, and he is the author of Icon Factory from 
HyperPress. He is also the author of numerous XCMD’s 
and XFCN’s, which include DoList, ListRes, and Sortit. 
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Figure 1 
The first card of VersaCad’s “Bill of Materials” stack that allows 
manipulation and cataloging of the elements of a VersaCad 
drawing from directly within a HyperCard stack. 


are provided, along with examples. VersaCad Corpora- 
tion is strongly encouraging us to make our own stacks, 
putting the power and flexibility of HyperCard and Ver- 
saCad together for individual users. Also, they are spon- 
soring a HyperCard Design Stack contest to further 
inspire people to find new ways to use HyperCad. 


How HyperCad Works 

At the heart of HyperCad are two XFCN’s. Yes, 
that’s right, only two. One XFCN is named getvcad, and 
the other is called putvcad. It’s not hard to figure out 
what these two commands do. The getvcad function 
reads information from a VersaCad drawing file, and the 
putvcad function saves drawing information back to a 
VersaCad drawing file. These XFCN’s are very general, 
leaving maximum flexibility in the hands of the person 
writing the stack. 

VersaCad drawing files are made up of records. 
There are several different types of records, each type 
has its own format and specific information. There are 
records types that hold drawing information, saved win- 
dows, plot specs, object data, symbol control info, and 
symbol object data. If these don’t mean much to you, 
don’t worry, they are explained in detail in the Versa- 
Cad manual. Also, it’s possible that only one or two of 


55 


the record types is relevant for a 
specific project, making it possible 
to concentrate on fewer things at a 
time while writing a stack. 

Using the getvcad XFCN, we 
can get a specific record from a 
drawing file, and put it into a Hyper- 
Card container. Each line in the con- 
tainer has one piece of information 
from the record. The line numbers 
for each piece of data are included 
in the information provided by Ver- 
saCad Corporation. After we have 
read a record, we can pick and 
choose the pieces of data we want 
to work with. We can also change 
any part of the data and save it back 
to the file using the putvcad XFCN. 

The HyperCard stacks that 
come with VersaCad are perfect 
examples of what can be done with 
the XFCN’s. For example, there is a 
“Bills of Materials” stack (see Figure 
1) that lists the materials needed for 
production of a VersaCad and calcu- 
lates the cost of the materials. The 
stack manages this by first using the 
getvcad XFCN to read information 
about the objects in the drawing. 
Then, it lets the user manipulate the 
information in typical HyperCard 
fashion (see Figure 2). A report fea- 
ture is also available which saves all 
the data in a text file which can be 
printed from a word processor. 
Changes to the drawing can also be 
saved back to the drawing file using 
putvcad. As usual, a good way to 
learn about how these stacks work 
is to examine them carefully. 

The flexibility of these XFCN’s 
is too great for me to describe here 
in more detail. The HyperCard 
Design Stack contest I mentioned 
earlier is for people who have spe- 
cific ideas for using HyperCard’s 
ease of use for extending the pro- 
ductivity of VersaCad. To enter the 
contest, you should get a copy of 
VersaCad/Macintosh Edition. Devel- 
oper pricing is available (at a 90% 
savings) for those who qualify. For 
more information, contact: 


VersaCad Corporation 

2124 Main Street 

Huntington Beach, CA 92648 
(714) 960-7720 


HyperEngine 

A product called HyperEngine 
is being published by Symmetry Cor- 
poration that gives application pro- 
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Figure 2 
The “Bill of Materials” stack not only extracts information from VersaCad drawing 
documents, it also sets up some excellent data storage and manipulation templates. 
Here, by counting objects in a VersaCad drawing and assigning parts and labor val- 
ues to each object type a complete cost estimate of the project is generated in 


HyperCard. 


Figure 3 
Adobe Illustrator is one of the many products that are turning to HyperCard and 
HyperEngine to integrate stacks as the cornerstones of their on-line help systems. 


grammers simple access to Hyper- 
Card flexibility. Application pro- 
grammers are people who write 
stand-alone programs. HyperCard 
can easily open an application from 
a stack, and many people have 
made use of this ability. Applica- 
tions, however, cannot easily open 
HyperCard stacks. Until HyperEn- 
gine came along, that is. 
HyperEngine provides a set of 
Toolbox routines for programmers 
to use when writing an application. 


[See this column in the Jan/Feb and 
Mar/April issues for information 
about Toolboxes—Ed.] These rou- 
tines can open and close stacks from 
the application. The only drawback 
is that the application must be writ- 
ten to use these routines. This 
means that an existing application 
would have to be re-written to some 
extent to use HyperEngine. If you 
don’t write applications, HyperEn- 
gine may not be something you are 
likely to find useful. Symmetry does 
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have a product called HyperDA, a 
Desk Accessory that can open stacks 


eau immenseeme A Now HyperCard'’ Tool For Your Good Health. 


is in effect a DA that uses 

ha 25 sshd ‘4 TM @ file Edit Go Tools Objects Meals Graphs Goodies 
RDAide ee 
Nutrient Analysis for HyperCard [252 5 c= 


Choices... We have so many foods to choose from in 
the 80's that making good choices is difficult. Deciding 
which foods to eat is as important to the quality and 
length of our lives as any decision we make. But how do 

[fay WE Choose the right foods? 


What Can It Do? 


HyperEngine can open a stack, 
and allow you to browse through it. 
There are some limitations to keep 
in mind, mainly that stacks can only 
be browsed and cannot be altered. 
Not all of HyperTalk is supported by 


HyperEngine, so things in some ~\ RDAide is an easy to use three stack HyperCard application for planning 
scripts may be ignored. Among _———— —_—j your meals or to see just what was in the foods you ate today. The 

things not supported are: Playing ee . __/ extensive database contains over 700 foods with room for many more. 
sounds, visual effects, looping, arith- ~. Y ~RDAide calculates your personal nutritional needs and saves daily meals. 


metic, XCMD’s and XFCN’s, and any 
HyperTalk command that changes 
something in the stack. Stacks that 
use unsupported scripts won’t 
bomb, but the unrecognized lines of 


RDAide also educates you with 
nutrient information and lists of foods that are high or 
low in a certain nutrient. RDAides' graphs, charts, 
reports, powerful user friendly interface, and other 
features make RDAide a great value and a useful tool 


"RDAide sets an example of what 
good HyperCard stackware can 
be.” 

-Caryle Hirshberg, MacGuide 


scripting will be ignored. At first, in maintaining your health. ae 
this may look like a major draw- This is a great tool for tracking 
back, and you may wonder why RDAide will help you make the proper choices... your diet. It makes use of _ 
someone might use HyperEngine HyperCard to bring good dietary 
when so many stacks obviously RDAide is priced at $84.95. $3.00 S/H. Sept bag k 
depend on these unsupported CA residents add 6.5% sales tax. For information or 8 tte 

HyperTalk commands. Rest assured, to order: Print and Graphics Educational Systems, 

HyperEngine can be very useful if 450 Taraval St. #235, San Francisco, CA 94116 (415) 665-3924. 


it’s used to implement something HyperCard is a trademark of Apple Computer, Inc. RDAide and PAGES logo are trademarks of Print and Graphics Educational Systems. 
every application has. Or rather, 
should have—on-line help. 

An on-line help system is one 
where information about the pro- 
gram and its features is available 
from the program itself while it is 
running. It takes a lot of effort to 
write an on-line help system for an 
application, and many programmers 
just don’t do it. Also, in many cases, 
the skills required to write a good 
program are very different from the 
skills needed to write good and 
easy-to-use on-line help. HyperEn- 
gine help solves these problem 
nicely. The application can be writ- 
ten to use HyperEngine for a help 
system (see Figure 3). Then, after 


The commercial 


HyperCard. 


software source! 


maxStax+™ delivers | 


... the software 
that really works! 


the application is finished, a Hyper- Choose from dozens of exciting programs. 
Card stack can be created to serve x i 

as the help stack. The help stack @ Entertainment @ Leisure 
could even be written by somebody M@ Education M@ Graphics 
who doesn’t know the first thing H Business HI Utilities 


about writing an application, but is 
good at writing manuals and on-line 
help. But what about the limitations Write for our FREE catalog. 
of HyperEngine, you ask? Well, an 
on-line help system doesn’t need to 


use much HyperTalk, and is per- OG aa AS 3 2 EACY 2” 
fectly suited to a browsing RO? NP Lee \ arm 
environment. P.O. Box 2719 Dept. 5, Oakland, CA 94602 


“Quality software without the expensive packaging.” 
HyperLink Magazine 


How It Works 


HyperEngine is a collection of 
two functions and four procedures, 
six routines in all. It can be used 
easily from either Pascal, C, or 
assembly language. The routines 
perform the following functions: 
Open a stack, close a stack, go to a 
card with a specific ID, and handle 
an event for the stack. There is also 
a routine that needs to be called in 
the main event loop of the applica- 
tion as often as possible, and a func- 
tion that returns error codes. 

For stack writers, the HyperEn- 
gine manual lists all the HyperTalk 
commands supported by HyperEn- 
gine, and offers ideas and tips for 
writing stacks to work specifically 
with HyperEngine. These tips and 
ideas are also valuable if you would 
like your stack to be as useful as 
possible when it is opened with 
HyperDA. For more information 
about HyperEngine, contact: 


Symmetry Corporation 
761 E. University Drive 
Mesa, Arizona 85203 
(602) 844-2199 


HyperTools #1 includes: 

Icon Editor 

Radio Button Group 

Check Box Group 

scan Cards 

Stack Stats 

Alignment Tools 

Info Tools 

Edit Script 

Create Arrays of Btns & Fields 
Get a Line # in scrollable Field 
Button Tools 

Free Space 

Font Tools 

Xcmd Tools 

Cursor Tools 

Stack Watch 
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HyperTools ‘1 


Box 2285, Huntington, CT 06484 (203) 926-1116 


Hypercard is a Registered Trademark of Apple Computer. HyperTools is a trademark of Softworks Inc. 


The technical details about 
HyperEngine and VersaCad’s Hyper- 
Cad XFCN’s are beyond the scope 
of this column, and it’s been my 
intention only to describe what the 
products are, giving examples of 
how they might be used. I believe 
that both of these products are sig- 
nificant in how they expand the 
flexibility and potential of Hyper- 
Card. During the last 18 months I’ve 
watched the number of HyperCard 
stacks grow tremendously, and Ver- 
saCad is the first truly high-powered 
application I have seen use Hyper- 
Card in such a natural and 
extremely productive way. HyperEn- 
gine approaches productivity from 
an interesting and useful angle. I’m 
aware of some major software devel- 
opers who are looking at HyperEn- 
gine for implementing their on-line 
help. These two products are just 
two examples of how the Hyper- 
Card concept is working its way 
into all types of Macintosh produc- 
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Give your Stacks the one- Two Punch 


HyperTools™ #1 includes 16 time saving tools for designing stacks and creating scripts. HyperTools™ #2 includes 
16 tools to add versatility to existing commercial and personal stackware to speed data entry, enhance the visual 
presentation and formatting of data. Both products extend the capabilities of HyperCard®. 
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HyperTools™ — Great for novices 
& experts! Includes latest version of 
HyperCard®. Suggested list $99.95 


Hypercard™ stack for cataloging 
family tree information. 
Automatic links between relations, 
unlimited number of generations ana 
spouses. 


Help and demo included. 
Works with MORE™ or your word 
processor to print tree charts 


$30 US Check or Money Order 
Payable to Joel Finkle 
Demo available from 
CompuServe, Educorp 


9235 Fern Ln 
Des Plaines, IL 60016 
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HyperTools #2 includes: 
¢ Group Tools 
¢ Choice Lists for Fields 
¢ Sort Lines 
Scan Cards 
Free Space 
Global Number Format 
Order Info for Btns & Fields 
Hide & Seek Tools 
Field Validation 
Display Formatting of data 
Reorder Cards Tool 
View Fonts Tool 
SoundTools 
Stack Stats 
Visual Effects Tool 
Stack Watch 
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Attention All Macintosh Developers and Users 


Announcing 


¢ Fully relational database 

¢ Multi-key indexing 

¢ Compiled field constraints 
¢ Supports databases up to 4 gigabytes in size 


¢ Each database may have up to 1000 relational tables. 


¢ No runtime fees for developers. Distribute the applications developed 
without additional charges. Ideal for shareware developers. 


¢ Fully relational database access including transparent join and select. 


¢ GridFile databases are designed with an interactive tool which allows you to rapidly develop intricate 
databases. 


¢ Performs consistency checks for intersecting fields of joined relations during all update and insertion 
operations. 


¢ Supports field types of byte, integer, long integer, floating point, character string, and numeric string. 
Strings are variable in size and may be up to 1024 bytes for character strings and up to 40 bytes for 
numeric strings. 


¢ Binary data of any size may be attached to each record. Limited only by the size of memory, this 
feature can be used to store PICT’s, bitmaps, and other Macintosh items. 


¢ Up to 10 times faster than B-Tree databases. Fully specified records are found within two disk reads 
regardless of the database size. 


¢ Available for HyperCard, “SuperCard, and LightSpeed C. Other languages available soon. 


For additional information contact: 


NovaSoft Engineering Group, Inc. 


2343 S. Ridgewood Ave. * Edgewater, FL 32032 « (904) 423-5189 
FAX (904) 428-0765 


HyperCard and Macintosh are trademarks of Apple Computer, Inc. LightSpeed C is a trademark of Think Technologies. 


How Does the First HyperTalk Compiler 
Meet the Needs of Scripters? 


Compilelt! 


he opening screen of Compilelt/ says it is “The 

Script Compiler,” but it might better be called 

“The Handler Compiler.” The limitations in the 
present version (1.1) might be enough to scare off the 
uninitiated. The good news is that version 1.2 is on the 
way and promises some great improvements. 


Compiling May Not Be for Everybody 

HyperCard was designed to be immediately 
accessible to even a naive Macintosh user. Compilelt/ is 
not. It is, in the words of the manual, “a development 
tool for experienced HyperTalk scripters.” The first thing 
Heizer’s HyperCard chief Brian Molyneaux told me as 
he handed me a copy of Compilelt!/ was “Read the man- 
ual.” After reading it, which is short but complete, even 
if it may be little too technical for many HyperCard 
users, I realize that compilers have never been meant 
“for the rest of us.” When something goes wrong with 
an interpreted program, such as a HyperTalk script, you 
are generally left staring at a simple error message. You 
fix it and try again. A compiled program must be 
designed and written carefully. When something goes 
wrong with a compiled program written in Pascal or C, 
you can easily bomb your system and end up looking at 
a screen full of what looks like refried bits. 

To bring compilation to HyperCard is not simple. 
It is to programmer Tom Pittman’s credit that he has 
combined the standard HyperCard environment with a 
time saving compiler written virtually all in HyperTalk. 


What CompilelIt! Is, and What It’s Not 


Compilelt/ is a HyperCard tool, like many other 
HyperCard tools. To a sophisticated scripter who wants 
to selectively speed up scripts that are slow because they 
are interpreted, it can be a powerful addition to a stack- 
ware developer’s toolkit. 

Compilelt/ is not the answer, however, to all your 
HyperTalk speed problems. You don’t create instant 
compiled HyperTalk by opening your latest stack and 
pushing the magic “Compile” button. In addition, it is 
not a direct link to SANE (Apple’s highly sophisticated 
Standard Apple Numerics Environment). It only does 
integer arithmetic—no decimals .There are ways to work 
around this, but even simple division is a bit 
complicated. 
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=) Compile Options: 

=) (J Enable names from 
me Inside Macintosh 
| (] Don’t compact 


Enter new script ) [24 Clickhereto 2) (] Show the action 
si “h] paste this button F::: Cit takes longer to compile) 
:] { Edit previous script } 2] ‘te You" Home or Be) 52 Screen blanker on 


“4 development stack fF: 


: ©1989 Tom Pittman. All Rights Reserved. Call 415-943-7667, 9am-Spm Pacific time for support. f: 


Paste & Compile ) | 


Version 1.1 Limitations 

One limitation is that Compilelt/ is written in 
HyperTalk and consequently runs very slowly. Even a 
trivially short script can take a minute or two to com- 
pile. The major limitation of version 1.1 is that only a 
subset of HyperTalk is supported. Certain very useful 
commands and keywords are off limits in a Compilelt/ 
script. For example, the words target, visible, rect, 
result, params, even the word the , are simply are 
not available. Accessing and changing most object prop- 
erties is also not an option. This means scripts must be 
tailored to fit—not exactly what the average scripter was 
dreaming of. 

Heizer has good news for us here. Version 1.2—a 
free upgrade sent automatically to registered users— 
should be out (you guessed it) by the time you read 
this. They tell us it will support a// of HyperTalk’s key- 
words. The only drawback is that this does not mean all 
HyperTalk commands will be sped up. Every time you 
use a command that requires HyperCard itself do some- 
thing, go to a card, put or get anything, and so on, 
your compiled script has to ask HyperCard just like you 
do from a regular script. These so called “callbacks” to 
HyperCard take the same amount of time (or longer in 
some cases) than your regular script. So even removing 
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Listing 1 


A script to test Compilelt! It merges two alphabetized fields that contain many similar 
entries into a single alphabetized field with no duplications in the final field. Only the 


function was sindeoaaal 


onmouseUp > 
put field 1 into sting. 
put field 2 into ne 
set cursor to watch - 


put mergeString ‘into field ‘oe 
end mouseUp 


function mergeLists stringl, string 
put 1 into lineofl _. 
put 1 into lineof2 — _ 
repeat until (line lineofl. of stringl) 
(line lineof2 of string2) =. — 
put line lineofl of string] into 
put line lineof2 or seringe into line 


if linel = line2 
then | | — 
put linel & return after mergestring. 
add 1 to lineofl | : — 
add 1 to lineof2 
else if linel < line2” : 
then 
put linel & return after mergeString 
add 1 to lineofl . 
else . 
put line2 & return after nergeString 
add 1 to lineof2 
end if 
end repeat 
return mergeString 
end mergeLists 


the limitations to script words doesn’t change the fact 
that Compilelt/ can only do some things faster. The bot- 
tom line is that even with the new version of Compilelt!, 
you must tailor scripts to take advantage of what Com- 
pilelt! does well, and leave out those things where it 
does not help. This means putting your scripts into dif- 
ferent modules and calling the compiled scripts just as 
you call any XCMD or XFCN. 

Compilelt/ has always supported direct calls to the 
Macintosh Toolbox in Read Only Memory (ROM). The 
advantage of having access to “ROM” calls may be 
apparent to only a few sophisticated Mac users. The 
average user might be lost as to how to employ the 
extremely powerful Macintosh Toolbox. Heizer is plan- 
ning to release at the same time as Version 1.2 an add- 
on disk of developer tools. These will help show you 
how to use these ROM calls to do things not available 
directly from HyperTalk. One example is a Compilelt! 
script that implements menus. The details of this subject 
are more suited to our “Xpanding HyperCard’ column. 
Suffice it to say, this is a great addition for the sophisti- 
cated or adventuresome One must determine for oneself 
if the effort required to learn about the Toolbox is worth 
the time involved. 


A Little Test 


Listing 1 shows a short routine that we wrote and 
compiled to see what kind of performance improvement 
Compilelt/ provides. The task is to merge two fully 
alphabetized user dictionaries generated from two, dif- 
ferent versions of Letraset’s page layout software, 
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Sort, Cross-ref., by topic 
() Search output to screen, printer, 
document 
QI Search by title, author, keyword, 
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CJ File import/export and segmentation 
The material you've collected 
represents a potentially valuable 
resource, realize that value! 
Order PRC today! 
Requires HyperCard V1.2 


Suggested List $72 
Delphinus, Inc. 
P.O. Box 458 
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(508) 448-2836 
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Computer, Inc. 
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INTERACTIVE DESIGN 


Custom HyperCard solutions for business. 
We’ve built stacks for Apple Computer, 
US West Direct, MacZone, and authored 
“101 Scripts and Buttons for HyperCard”’. 


(206) 542-9000 


Ready,Set,Go! 
These are simple 
text files easily 
imported into 
Fields 1 and 2 of 
a HyperCard 
stack. The routine 
simply merges 
the two into a 
third alphabetized 
field, so that 
there are no 
duplicate entries 
in the field. We compiled only the function mergeLists. 
The uncompiled routine takes from 1-1/2 to 4 minutes 
to operate (depending on the hardware) when merging 
two lists of 300-400 words each. Compiled, it takes 
about half that long. We’ve included it on our StackSolu- 
tions disk to demonstrate both compiled and uncom- 
piled versions so you can see for yourself the kind of 
savings that occur in this type of application. 

It took about 30 minutes to compile the 
mergeLists handler on a Mac II. We also did it ona 1 
megabyte Mac Plus, but after an hour and a half I went 
to bed. The next morning it was done and worked fine. 

In short, Compilelt/ can save you time if you are 
willing to spend some time. If you have a handler that 
takes a long time to operate, you have a choice. You 
can wait a long time, once, for the handler to compile. 
Or, you can wait every time you use the handler in your 
stacks. —Roger Wood 
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In praise of HyperCard’s easy 
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